@amigo-ai/platform-sdk 0.4.5 → 0.4.7

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2026 Amigo AI
+Copyright (c) 2026 Amigo Inc.
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -9,7 +9,7 @@
 <p align="center">
   <a href="https://docs.amigo.ai">Product Docs</a>
   ·
-  <a href="https://docs.amigo.ai/developer-guide">Developer Guide</a>
+  <a href="https://docs.amigo.ai/developer-guide/platform-api/platform-sdk">Developer Guide</a>
   ·
   <a href="https://docs.amigo.ai/api-reference">API Reference</a>
   ·
@@ -26,7 +26,7 @@
   <a href="https://opensource.org/licenses/MIT"><img src="https://img.shields.io/badge/License-MIT-blue.svg" alt="MIT License" /></a>
 </p>
 
-Typed from the committed `openapi.json` snapshot, validated on Node 18, 20, and 22, and tested as packaged ESM and CommonJS tarballs before release.
+Typed from the committed `openapi.json` snapshot, validated on active LTS Node releases (20, 22, and 24), and tested as packaged ESM and CommonJS tarballs before release.
 
 ## Platform context
 
@@ -39,7 +39,7 @@ The SDK is the typed client boundary between your runtime and the workspace-scop
 | Need                                        | Best entry point                                         |
 | ------------------------------------------- | -------------------------------------------------------- |
 | Product architecture and deployment context | [docs.amigo.ai](https://docs.amigo.ai/)                  |
-| Tutorials and integration guidance          | [Developer Guide](https://docs.amigo.ai/developer-guide) |
+| Tutorials and integration guidance          | [Developer Guide](https://docs.amigo.ai/developer-guide/platform-api/platform-sdk) |
 | Endpoint-by-endpoint REST reference         | [API Reference](https://docs.amigo.ai/api-reference)     |
 | Repo-local SDK examples                     | [examples/README.md](./examples/README.md)               |
 | Generated package surface                   | [api.md](./api.md)                                       |
@@ -119,7 +119,7 @@ The SDK is built around web-standard primitives. Use it in runtimes that provide
 - `TextEncoder` / `TextDecoder`
 - `crypto.subtle` for webhook signature verification
 
-CI currently validates Node-based packaging and runtime behavior. Standards-based edge/server runtimes with the same APIs work well with the low-level request wrappers.
+CI currently validates active LTS Node releases. Standards-based edge/server runtimes with the same APIs work well with the low-level request wrappers.
 
 ## Generated Types
 
@@ -586,18 +586,22 @@ const client = new AmigoClient({
 
 ## Pagination
 
-All list methods return `{ items, has_more, continuation_token }`. Use the `paginate` utility to iterate all pages automatically:
+The SDK now exposes first-class async auto-pagination helpers on collection resources:
 
 ```typescript
-import { AmigoClient, paginate } from '@amigo-ai/platform-sdk'
+import { AmigoClient } from '@amigo-ai/platform-sdk'
+
+for await (const agent of client.agents.listAutoPaging({ limit: 100 })) {
+  console.log(agent.name)
+}
 
-for await (const entity of paginate((token) =>
-  client.world.listEntities({ continuation_token: token, limit: 100 }),
-)) {
-  // process entity
+for await (const entity of client.world.listEntitiesAutoPaging({ limit: 100 })) {
+  console.log(entity.display_name)
 }
 ```
 
+For custom pagination flows, the lower-level `paginate(...)` utility remains available.
+
 ## Error handling
 
 All SDK errors extend `AmigoError`. Use type guards for specific handling:

package/api.md

@@ -61,6 +61,7 @@ All workspace-scoped resources also expose `withOptions(options)`.
 
 - `create`
 - `list`
+- `listAutoPaging`
 - `get`
 - `update`
 - `archive`
@@ -70,6 +71,7 @@ All workspace-scoped resources also expose `withOptions(options)`.
 - `me`
 - `create`
 - `list`
+- `listAutoPaging`
 - `revoke`
 - `rotate`
 
@@ -77,10 +79,12 @@ All workspace-scoped resources also expose `withOptions(options)`.
 
 - `create`
 - `list`
+- `listAutoPaging`
 - `get`
 - `update`
 - `delete`
 - `listVersions`
+- `listVersionsAutoPaging`
 - `getVersion`
 - `createVersion`
 
@@ -88,6 +92,7 @@ All workspace-scoped resources also expose `withOptions(options)`.
 
 - `create`
 - `list`
+- `listAutoPaging`
 - `get`
 - `update`
 - `delete`
@@ -97,19 +102,24 @@ All workspace-scoped resources also expose `withOptions(options)`.
 
 - `create`
 - `list`
+- `listAutoPaging`
 - `get`
 - `update`
 - `delete`
+- `getReferences`
 - `test`
 
 ### `operators`
 
 - `list`
+- `listAutoPaging`
 - `create`
 - `get`
+- `update`
 - `getDashboard`
 - `getQueue`
 - `getEscalations`
+- `getEscalationsAutoPaging`
 - `getActiveEscalations`
 - `getEscalationStats`
 - `getPerformance`
@@ -122,10 +132,12 @@ All workspace-scoped resources also expose `withOptions(options)`.
 - `wrapUp`
 - `getCallTranscript`
 - `getAuditLog`
+- `getAuditLogAutoPaging`
 
 ### `triggers`
 
 - `list`
+- `listAutoPaging`
 - `create`
 - `get`
 - `update`
@@ -134,11 +146,13 @@ All workspace-scoped resources also expose `withOptions(options)`.
 - `pause`
 - `resume`
 - `listRuns`
+- `listRunsAutoPaging`
 
 ### `services`
 
 - `create`
 - `list`
+- `listAutoPaging`
 - `get`
 - `update`
 - `delete`
@@ -147,17 +161,20 @@ All workspace-scoped resources also expose `withOptions(options)`.
 
 - `create`
 - `list`
+- `listAutoPaging`
 - `get`
 - `update`
 - `delete`
 - `createVersion`
 - `listVersions`
+- `listVersionsAutoPaging`
 - `getVersion`
 
 ### `dataSources`
 
 - `create`
 - `list`
+- `listAutoPaging`
 - `get`
 - `update`
 - `delete`
@@ -167,18 +184,24 @@ All workspace-scoped resources also expose `withOptions(options)`.
 ### `world`
 
 - `listEntities`
+- `listEntitiesAutoPaging`
 - `getEntity`
 - `getRelationships`
 - `getGraph`
 - `getProvenance`
 - `getLineage`
 - `getMerged`
+- `getConnectors`
+- `getConnectorEntities`
+- `getConnectorResources`
 - `listEntityTypes`
 - `listDuplicates`
 - `search`
 - `getTimeline`
+- `getTimelineAutoPaging`
 - `getSyncStatusBySink`
 - `listSyncEvents`
+- `listSyncEventsAutoPaging`
 - `getSyncQueueDepth`
 - `retrySyncEvent`
 - `retryAllSyncEvents`
@@ -188,16 +211,19 @@ All workspace-scoped resources also expose `withOptions(options)`.
 ### `calls`
 
 - `list`
+- `listAutoPaging`
 - `get`
 - `getIntelligence`
 - `getActiveIntelligence`
 - `getBenchmarks`
+- `getPhoneVolume`
 - `getTraceAnalysis`
 
 ### `phoneNumbers`
 
 - `provision`
 - `list`
+- `listAutoPaging`
 - `get`
 - `update`
 - `release`
@@ -208,6 +234,7 @@ All workspace-scoped resources also expose `withOptions(options)`.
 
 - `create`
 - `list`
+- `listAutoPaging`
 - `get`
 - `update`
 - `delete`
@@ -225,6 +252,9 @@ All workspace-scoped resources also expose `withOptions(options)`.
 - `getToolPerformance`
 - `getDataQuality`
 - `getUsage`
+- `getEventBreakdown`
+- `getSafetyTrends`
+- `getOperatorPerformance`
 - `getAdvancedCallStats`
 - `compareCallPeriods`
 
@@ -251,6 +281,16 @@ All workspace-scoped resources also expose `withOptions(options)`.
 - `security.update`
 - `retention.get`
 - `retention.update`
+- `behaviors.get`
+- `behaviors.update`
+- `gapScanner.get`
+- `gapScanner.update`
+- `scribe.get`
+- `scribe.update`
+- `metrics.get`
+- `metrics.update`
+- `environments.get`
+- `environments.update`
 - `workflows.get`
 - `workflows.update`
 
@@ -260,6 +300,7 @@ All workspace-scoped resources also expose `withOptions(options)`.
 - `getUsage`
 - `getUsageTrends`
 - `listInvoices`
+- `listInvoicesAutoPaging`
 - `getInvoice`
 - `getInvoicePdf`
 
@@ -272,6 +313,7 @@ All workspace-scoped resources also expose `withOptions(options)`.
 ### `personas`
 
 - `list`
+- `listAutoPaging`
 - `create`
 - `get`
 - `update`
@@ -280,10 +322,12 @@ All workspace-scoped resources also expose `withOptions(options)`.
 ### `reviewQueue`
 
 - `list`
+- `listAutoPaging`
 - `get`
 - `getStats`
 - `getDashboard`
 - `getMyQueue`
+- `getMyQueueAutoPaging`
 - `approve`
 - `reject`
 - `claim`
@@ -292,6 +336,7 @@ All workspace-scoped resources also expose `withOptions(options)`.
 - `batchApprove`
 - `batchReject`
 - `getHistory`
+- `getHistoryAutoPaging`
 - `getTrends`
 - `getPerformance`
 - `getCorrectionSchema`
@@ -306,20 +351,25 @@ All workspace-scoped resources also expose `withOptions(options)`.
 ### `audit`
 
 - `list`
+- `listAutoPaging`
 - `getSummary`
 - `getPhiAccess`
+- `getPhiAccessAutoPaging`
 - `createExport`
 - `listExports`
 - `getEntityAccessLog`
+- `getEntityAccessLogAutoPaging`
 
 ### `webhookDestinations`
 
 - `list`
+- `listAutoPaging`
 - `create`
 - `get`
 - `update`
 - `delete`
 - `listDeliveries`
+- `listDeliveriesAutoPaging`
 - `rotateSecret`
 
 ### `safety`