@amigo-ai/platform-sdk 0.4.4 → 0.4.6

package/README.md

@@ -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
 
@@ -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`

package/assets/readme/platform-architecture.svg

@@ -1,117 +1,103 @@
-<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="540" viewBox="0 0 1200 540">
+<svg xmlns="http://www.w3.org/2000/svg" width="1200" height="480" viewBox="0 0 1200 480">
   <defs>
-    <linearGradient id="bg" x1="0" y1="0" x2="1" y2="1">
-      <stop offset="0%" stop-color="#081E2A"/>
-      <stop offset="55%" stop-color="#0A2C3B"/>
-      <stop offset="100%" stop-color="#051822"/>
+    <linearGradient id="bg" x1="0" y1="0" x2="0.6" y2="1">
+      <stop offset="0%" stop-color="#083241"/>
+      <stop offset="100%" stop-color="#051A24"/>
     </linearGradient>
-    <radialGradient id="glowLeft" cx="0.2" cy="0.22" r="0.7">
-      <stop offset="0%" stop-color="#26C6FF" stop-opacity="0.18"/>
-      <stop offset="100%" stop-color="#26C6FF" stop-opacity="0"/>
-    </radialGradient>
-    <radialGradient id="glowRight" cx="0.84" cy="0.16" r="0.55">
-      <stop offset="0%" stop-color="#7DE1B5" stop-opacity="0.12"/>
-      <stop offset="100%" stop-color="#7DE1B5" stop-opacity="0"/>
-    </radialGradient>
-    <linearGradient id="panelStroke" x1="0" y1="0" x2="1" y2="1">
-      <stop offset="0%" stop-color="#FFFFFF" stop-opacity="0.14"/>
-      <stop offset="100%" stop-color="#92B4C3" stop-opacity="0.06"/>
+    <linearGradient id="strokeGrad" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0%" stop-color="white" stop-opacity="0.1"/>
+      <stop offset="100%" stop-color="#999" stop-opacity="0.04"/>
     </linearGradient>
-    <linearGradient id="highlightStroke" x1="0" y1="0" x2="1" y2="1">
-      <stop offset="0%" stop-color="#82E4FF" stop-opacity="0.92"/>
-      <stop offset="100%" stop-color="#64AFFF" stop-opacity="0.56"/>
+    <linearGradient id="strokeGradSubtle" x1="0" y1="0" x2="1" y2="1">
+      <stop offset="0%" stop-color="white" stop-opacity="0.08"/>
+      <stop offset="100%" stop-color="#999" stop-opacity="0.03"/>
     </linearGradient>
-    <linearGradient id="arrowStroke" x1="0" y1="0" x2="1" y2="0">
-      <stop offset="0%" stop-color="#8EE4FF"/>
-      <stop offset="100%" stop-color="#7FC8FF"/>
-    </linearGradient>
-    <marker id="arrow" viewBox="0 0 12 12" refX="10.5" refY="6" markerWidth="8" markerHeight="8" orient="auto">
-      <path d="M 0 0 L 12 6 L 0 12 z" fill="#8EE4FF"/>
+    <marker id="arrow" viewBox="0 0 10 7" refX="9" refY="3.5" markerWidth="8" markerHeight="6" orient="auto-start-reverse">
+      <path d="M 0 0.5 L 9 3.5 L 0 6.5" fill="none" stroke="white" stroke-width="1" opacity="0.2"/>
     </marker>
   </defs>
 
-  <rect width="1200" height="540" fill="url(#bg)"/>
-  <rect width="1200" height="540" fill="url(#glowLeft)"/>
-  <rect width="1200" height="540" fill="url(#glowRight)"/>
-
-  <text x="68" y="62" font-family="'SFMono-Regular', Menlo, monospace" font-size="13" font-weight="600" fill="#BBD1DC" letter-spacing="2.4">PLATFORM CONTEXT</text>
-  <text x="68" y="98" font-family="'Inter', 'Helvetica Neue', Arial, sans-serif" font-size="30" font-weight="700" fill="white">How the TypeScript SDK fits into the stack</text>
-  <text x="68" y="126" font-family="'Inter', 'Helvetica Neue', Arial, sans-serif" font-size="15" fill="#A9C0CB">Your runtime calls the SDK, the SDK targets the workspace-scoped Platform API, and the API fronts the operational systems behind the product.</text>
-
-  <rect x="60" y="152" width="246" height="208" rx="22" fill="white" fill-opacity="0.045" stroke="url(#panelStroke)" stroke-width="1"/>
-  <text x="88" y="184" font-family="'SFMono-Regular', Menlo, monospace" font-size="12" font-weight="600" fill="#B4C9D4" letter-spacing="2">YOUR RUNTIME</text>
+  <rect width="1200" height="480" fill="url(#bg)"/>
 
-  <rect x="82" y="206" width="202" height="42" rx="12" fill="#173E4D" fill-opacity="0.95" stroke="white" stroke-opacity="0.06"/>
-  <text x="183" y="231" text-anchor="middle" font-family="'Inter', 'Helvetica Neue', Arial, sans-serif" font-size="16" font-weight="600" fill="white">Node servers</text>
+  <!-- ====== PLATFORM SYSTEMS (top) ====== -->
+  <rect x="32" y="32" width="880" height="260" rx="10" fill="white" fill-opacity="0.03" stroke="url(#strokeGrad)" stroke-width="0.75"/>
+  <text x="60" y="60" font-family="'Diatype Mono', 'SF Mono', monospace" font-size="13" font-weight="500" fill="white" fill-opacity="0.55" letter-spacing="2">PLATFORM SYSTEMS</text>
 
-  <rect x="82" y="260" width="202" height="42" rx="12" fill="#173E4D" fill-opacity="0.88" stroke="white" stroke-opacity="0.06"/>
-  <text x="183" y="285" text-anchor="middle" font-family="'Inter', 'Helvetica Neue', Arial, sans-serif" font-size="16" font-weight="600" fill="white">Workers and jobs</text>
+  <!-- Row 1 -->
+  <rect x="52" y="78" width="200" height="60" rx="8" fill="white" fill-opacity="0.1" stroke="url(#strokeGradSubtle)" stroke-width="0.75"/>
+  <text x="152" y="103" text-anchor="middle" font-family="'Flecha S', Georgia, serif" font-size="16" fill="white" fill-opacity="0.95">Agent Engine</text>
+  <text x="152" y="121" text-anchor="middle" font-family="Inter, sans-serif" font-size="12" fill="white" fill-opacity="0.7">Phone, text, simulation</text>
 
-  <rect x="82" y="314" width="202" height="42" rx="12" fill="#173E4D" fill-opacity="0.82" stroke="white" stroke-opacity="0.06"/>
-  <text x="183" y="339" text-anchor="middle" font-family="'Inter', 'Helvetica Neue', Arial, sans-serif" font-size="16" font-weight="600" fill="white">Edge or BFF layers</text>
+  <rect x="268" y="78" width="200" height="60" rx="8" fill="white" fill-opacity="0.1" stroke="url(#strokeGradSubtle)" stroke-width="0.75"/>
+  <text x="368" y="103" text-anchor="middle" font-family="'Flecha S', Georgia, serif" font-size="16" fill="white" fill-opacity="0.95">Clinical Copilot</text>
+  <text x="368" y="121" text-anchor="middle" font-family="Inter, sans-serif" font-size="12" fill="white" fill-opacity="0.7">SOAP, ICD-10, CDS</text>
 
-  <rect x="366" y="128" width="338" height="256" rx="24" fill="#0D3446" fill-opacity="0.9" stroke="url(#highlightStroke)" stroke-width="1.5"/>
-  <text x="394" y="162" font-family="'SFMono-Regular', Menlo, monospace" font-size="12" font-weight="600" fill="#BFEBFF" letter-spacing="2">SDK LAYER</text>
-  <text x="394" y="214" font-family="'SFMono-Regular', Menlo, monospace" font-size="28" font-weight="700" fill="white">@amigo-ai/platform-sdk</text>
-  <text x="394" y="245" font-family="'Inter', 'Helvetica Neue', Arial, sans-serif" font-size="16" fill="#C4D8E1">Typed workspace-scoped client for the Platform API.</text>
-  <text x="394" y="271" font-family="'Inter', 'Helvetica Neue', Arial, sans-serif" font-size="16" fill="#C4D8E1">It keeps auth, retries, webhooks, request control,</text>
-  <text x="394" y="295" font-family="'Inter', 'Helvetica Neue', Arial, sans-serif" font-size="16" fill="#C4D8E1">and generated types on the package surface.</text>
+  <rect x="484" y="78" width="200" height="60" rx="8" fill="white" fill-opacity="0.08" stroke="url(#strokeGradSubtle)" stroke-width="0.75"/>
+  <text x="584" y="103" text-anchor="middle" font-family="'Flecha S', Georgia, serif" font-size="16" fill="white" fill-opacity="0.95">Emotion Engine</text>
+  <text x="584" y="121" text-anchor="middle" font-family="Inter, sans-serif" font-size="12" fill="white" fill-opacity="0.7">Acoustic intelligence</text>
 
-  <rect x="394" y="321" width="114" height="30" rx="15" fill="#123D50" stroke="#7CCFFF" stroke-opacity="0.28"/>
-  <text x="451" y="340" text-anchor="middle" font-family="'Inter', 'Helvetica Neue', Arial, sans-serif" font-size="13" font-weight="600" fill="#DFF4FF">Typed surface</text>
-  <rect x="519" y="321" width="104" height="30" rx="15" fill="#123D50" stroke="#7CCFFF" stroke-opacity="0.22"/>
-  <text x="571" y="340" text-anchor="middle" font-family="'Inter', 'Helvetica Neue', Arial, sans-serif" font-size="13" font-weight="600" fill="#DFF4FF">ESM + CJS</text>
-  <rect x="394" y="360" width="110" height="30" rx="15" fill="#123D50" stroke="#7CCFFF" stroke-opacity="0.22"/>
-  <text x="449" y="379" text-anchor="middle" font-family="'Inter', 'Helvetica Neue', Arial, sans-serif" font-size="13" font-weight="600" fill="#DFF4FF">Webhooks</text>
-  <rect x="515" y="360" width="136" height="30" rx="15" fill="#123D50" stroke="#7CCFFF" stroke-opacity="0.22"/>
-  <text x="583" y="379" text-anchor="middle" font-family="'Inter', 'Helvetica Neue', Arial, sans-serif" font-size="13" font-weight="600" fill="#DFF4FF">Request control</text>
+  <rect x="700" y="78" width="192" height="60" rx="8" fill="white" fill-opacity="0.08" stroke="url(#strokeGradSubtle)" stroke-width="0.75"/>
+  <text x="796" y="103" text-anchor="middle" font-family="'Flecha S', Georgia, serif" font-size="16" fill="white" fill-opacity="0.95">Connector Runner</text>
+  <text x="796" y="121" text-anchor="middle" font-family="Inter, sans-serif" font-size="12" fill="white" fill-opacity="0.7">EHR, FHIR, CRM sync</text>
 
-  <rect x="764" y="110" width="376" height="296" rx="22" fill="white" fill-opacity="0.045" stroke="url(#panelStroke)" stroke-width="1"/>
-  <text x="792" y="142" font-family="'SFMono-Regular', Menlo, monospace" font-size="12" font-weight="600" fill="#B4C9D4" letter-spacing="2">PLATFORM API</text>
-  <text x="792" y="172" font-family="'Inter', 'Helvetica Neue', Arial, sans-serif" font-size="15" fill="#C0D4DE">Workspace-scoped REST resources exposed by the SDK.</text>
+  <!-- Row 2 -->
+  <rect x="52" y="152" width="200" height="60" rx="8" fill="white" fill-opacity="0.08" stroke="url(#strokeGradSubtle)" stroke-width="0.75"/>
+  <text x="152" y="177" text-anchor="middle" font-family="'Flecha S', Georgia, serif" font-size="16" fill="white" fill-opacity="0.95">Operators</text>
+  <text x="152" y="195" text-anchor="middle" font-family="Inter, sans-serif" font-size="12" fill="white" fill-opacity="0.7">Monitoring, escalation</text>
 
-  <rect x="792" y="198" width="148" height="54" rx="14" fill="#173E4D" fill-opacity="0.9" stroke="white" stroke-opacity="0.06"/>
-  <text x="866" y="222" text-anchor="middle" font-family="'Inter', 'Helvetica Neue', Arial, sans-serif" font-size="17" font-weight="600" fill="white">Agents</text>
-  <text x="866" y="241" text-anchor="middle" font-family="'Inter', 'Helvetica Neue', Arial, sans-serif" font-size="12" fill="#B0C5CF">Actions, skills, services</text>
+  <rect x="268" y="152" width="200" height="60" rx="8" fill="white" fill-opacity="0.08" stroke="url(#strokeGradSubtle)" stroke-width="0.75"/>
+  <text x="368" y="177" text-anchor="middle" font-family="'Flecha S', Georgia, serif" font-size="16" fill="white" fill-opacity="0.95">Metric Store</text>
+  <text x="368" y="195" text-anchor="middle" font-family="Inter, sans-serif" font-size="12" fill="white" fill-opacity="0.7">Config-driven analytics</text>
 
-  <rect x="962" y="198" width="148" height="54" rx="14" fill="#173E4D" fill-opacity="0.86" stroke="white" stroke-opacity="0.06"/>
-  <text x="1036" y="222" text-anchor="middle" font-family="'Inter', 'Helvetica Neue', Arial, sans-serif" font-size="17" font-weight="600" fill="white">Calls</text>
-  <text x="1036" y="241" text-anchor="middle" font-family="'Inter', 'Helvetica Neue', Arial, sans-serif" font-size="12" fill="#B0C5CF">Voice, history, recordings</text>
+  <rect x="484" y="152" width="200" height="60" rx="8" fill="white" fill-opacity="0.08" stroke="url(#strokeGradSubtle)" stroke-width="0.75"/>
+  <text x="584" y="177" text-anchor="middle" font-family="'Flecha S', Georgia, serif" font-size="16" fill="white" fill-opacity="0.95">Surfaces</text>
+  <text x="584" y="195" text-anchor="middle" font-family="Inter, sans-serif" font-size="12" fill="white" fill-opacity="0.7">Forms, data capture</text>
 
-  <rect x="792" y="270" width="148" height="54" rx="14" fill="#173E4D" fill-opacity="0.86" stroke="white" stroke-opacity="0.06"/>
-  <text x="866" y="294" text-anchor="middle" font-family="'Inter', 'Helvetica Neue', Arial, sans-serif" font-size="17" font-weight="600" fill="white">World</text>
-  <text x="866" y="313" text-anchor="middle" font-family="'Inter', 'Helvetica Neue', Arial, sans-serif" font-size="12" fill="#B0C5CF">Entities and events</text>
+  <rect x="700" y="152" width="192" height="60" rx="8" fill="white" fill-opacity="0.08" stroke="url(#strokeGradSubtle)" stroke-width="0.75"/>
+  <text x="796" y="177" text-anchor="middle" font-family="'Flecha S', Georgia, serif" font-size="16" fill="white" fill-opacity="0.95">Outbound Dispatch</text>
+  <text x="796" y="195" text-anchor="middle" font-family="Inter, sans-serif" font-size="12" fill="white" fill-opacity="0.7">Campaigns, follow-ups</text>
 
-  <rect x="962" y="270" width="148" height="54" rx="14" fill="#173E4D" fill-opacity="0.82" stroke="white" stroke-opacity="0.06"/>
-  <text x="1036" y="294" text-anchor="middle" font-family="'Inter', 'Helvetica Neue', Arial, sans-serif" font-size="17" font-weight="600" fill="white">Analytics</text>
-  <text x="1036" y="313" text-anchor="middle" font-family="'Inter', 'Helvetica Neue', Arial, sans-serif" font-size="12" fill="#B0C5CF">Dashboards and trends</text>
+  <!-- Annotation: read + write -->
+  <text x="472" y="248" text-anchor="middle" font-family="Inter, sans-serif" font-size="12" font-weight="500" fill="white" fill-opacity="0.5">read + write</text>
+  <line x1="390" y1="254" x2="390" y2="280" stroke="white" stroke-width="1" stroke-opacity="0.15" marker-end="url(#arrow)"/>
+  <line x1="555" y1="254" x2="555" y2="280" stroke="white" stroke-width="1" stroke-opacity="0.15" marker-end="url(#arrow)"/>
 
-  <rect x="792" y="342" width="148" height="54" rx="14" fill="#173E4D" fill-opacity="0.82" stroke="white" stroke-opacity="0.06"/>
-  <text x="866" y="366" text-anchor="middle" font-family="'Inter', 'Helvetica Neue', Arial, sans-serif" font-size="17" font-weight="600" fill="white">Webhooks</text>
-  <text x="866" y="385" text-anchor="middle" font-family="'Inter', 'Helvetica Neue', Arial, sans-serif" font-size="12" fill="#B0C5CF">Signed inbound events</text>
+  <!-- ====== CLASSIC API (top right) ====== -->
+  <rect x="940" y="32" width="228" height="260" rx="10" fill="white" fill-opacity="0.03" stroke="url(#strokeGrad)" stroke-width="0.75"/>
+  <text x="968" y="60" font-family="'Diatype Mono', 'SF Mono', monospace" font-size="13" font-weight="500" fill="white" fill-opacity="0.55" letter-spacing="2">CLASSIC API</text>
 
-  <rect x="962" y="342" width="148" height="54" rx="14" fill="#173E4D" fill-opacity="0.78" stroke="white" stroke-opacity="0.06"/>
-  <text x="1036" y="366" text-anchor="middle" font-family="'Inter', 'Helvetica Neue', Arial, sans-serif" font-size="17" font-weight="600" fill="white">Operations</text>
-  <text x="1036" y="385" text-anchor="middle" font-family="'Inter', 'Helvetica Neue', Arial, sans-serif" font-size="12" fill="#B0C5CF">Operators, integrations, numbers</text>
+  <rect x="960" y="78" width="188" height="60" rx="8" fill="white" fill-opacity="0.08" stroke="url(#strokeGradSubtle)" stroke-width="0.75"/>
+  <text x="1054" y="103" text-anchor="middle" font-family="'Flecha S', Georgia, serif" font-size="16" fill="white" fill-opacity="0.95">Text Chat</text>
+  <text x="1054" y="121" text-anchor="middle" font-family="Inter, sans-serif" font-size="12" fill="white" fill-opacity="0.7">WebSocket streaming</text>
 
-  <path d="M 306 256 C 328 256 344 256 366 256" fill="none" stroke="url(#arrowStroke)" stroke-width="2.5" stroke-linecap="round" marker-end="url(#arrow)"/>
+  <rect x="960" y="152" width="188" height="60" rx="8" fill="white" fill-opacity="0.08" stroke="url(#strokeGradSubtle)" stroke-width="0.75"/>
+  <text x="1054" y="177" text-anchor="middle" font-family="'Flecha S', Georgia, serif" font-size="16" fill="white" fill-opacity="0.95">User Models</text>
+  <text x="1054" y="195" text-anchor="middle" font-family="Inter, sans-serif" font-size="12" fill="white" fill-opacity="0.7">Memory, personalization</text>
 
-  <path d="M 704 256 C 728 256 740 256 764 256" fill="none" stroke="url(#arrowStroke)" stroke-width="2.5" stroke-linecap="round" marker-end="url(#arrow)"/>
+  <!-- Classic API annotation -->
+  <text x="1054" y="248" text-anchor="middle" font-family="Inter, sans-serif" font-size="12" font-weight="500" fill="white" fill-opacity="0.5">read + write</text>
+  <line x1="1054" y1="254" x2="1054" y2="280" stroke="white" stroke-width="1" stroke-opacity="0.15" marker-end="url(#arrow)"/>
 
-  <path d="M 952 406 C 952 420 952 430 952 446" fill="none" stroke="url(#arrowStroke)" stroke-width="2.5" stroke-linecap="round" marker-end="url(#arrow)"/>
+  <!-- ====== WORLD MODEL (bottom foundation) ====== -->
+  <rect x="32" y="290" width="1136" height="150" rx="10" fill="white" fill-opacity="0.05" stroke="url(#strokeGrad)" stroke-width="0.75"/>
+  <text x="60" y="318" font-family="'Diatype Mono', 'SF Mono', monospace" font-size="13" font-weight="500" fill="white" fill-opacity="0.55" letter-spacing="2">WORLD MODEL</text>
 
-  <rect x="60" y="448" width="1080" height="70" rx="20" fill="white" fill-opacity="0.05" stroke="url(#panelStroke)" stroke-width="1"/>
-  <text x="88" y="477" font-family="'SFMono-Regular', Menlo, monospace" font-size="12" font-weight="600" fill="#B4C9D4" letter-spacing="2">PLATFORM SYSTEMS</text>
+  <rect x="52" y="336" width="260" height="60" rx="8" fill="white" fill-opacity="0.1" stroke="url(#strokeGradSubtle)" stroke-width="0.75"/>
+  <text x="182" y="361" text-anchor="middle" font-family="'Flecha S', Georgia, serif" font-size="16" fill="white" fill-opacity="0.95">Event Store</text>
+  <text x="182" y="379" text-anchor="middle" font-family="Inter, sans-serif" font-size="12" fill="white" fill-opacity="0.7">Confidence-scored, immutable facts</text>
 
-  <rect x="84" y="487" width="238" height="18" rx="9" fill="#173E4D" fill-opacity="0.84"/>
-  <text x="203" y="500" text-anchor="middle" font-family="'Inter', 'Helvetica Neue', Arial, sans-serif" font-size="11" font-weight="600" fill="#D6E7EE">Connectors and EHR sync</text>
+  <rect x="332" y="336" width="260" height="60" rx="8" fill="white" fill-opacity="0.08" stroke="url(#strokeGradSubtle)" stroke-width="0.75"/>
+  <text x="462" y="361" text-anchor="middle" font-family="'Flecha S', Georgia, serif" font-size="16" fill="white" fill-opacity="0.95">Entity Projections</text>
+  <text x="462" y="379" text-anchor="middle" font-family="Inter, sans-serif" font-size="12" fill="white" fill-opacity="0.7">Entity state from events</text>
 
-  <rect x="350" y="487" width="222" height="18" rx="9" fill="#173E4D" fill-opacity="0.84"/>
-  <text x="461" y="500" text-anchor="middle" font-family="'Inter', 'Helvetica Neue', Arial, sans-serif" font-size="11" font-weight="600" fill="#D6E7EE">World model and projections</text>
+  <rect x="612" y="336" width="260" height="60" rx="8" fill="white" fill-opacity="0.08" stroke="url(#strokeGradSubtle)" stroke-width="0.75"/>
+  <text x="742" y="361" text-anchor="middle" font-family="'Flecha S', Georgia, serif" font-size="16" fill="white" fill-opacity="0.95">Intelligence Projections</text>
+  <text x="742" y="379" text-anchor="middle" font-family="Inter, sans-serif" font-size="12" fill="white" fill-opacity="0.7">Memory, scheduling, clinical</text>
 
-  <rect x="600" y="487" width="226" height="18" rx="9" fill="#173E4D" fill-opacity="0.84"/>
-  <text x="713" y="500" text-anchor="middle" font-family="'Inter', 'Helvetica Neue', Arial, sans-serif" font-size="11" font-weight="600" fill="#D6E7EE">Operators and outbound automation</text>
+  <rect x="892" y="336" width="256" height="60" rx="8" fill="white" fill-opacity="0.08" stroke="url(#strokeGradSubtle)" stroke-width="0.75"/>
+  <text x="1020" y="361" text-anchor="middle" font-family="'Flecha S', Georgia, serif" font-size="16" fill="white" fill-opacity="0.95">Vector Search</text>
+  <text x="1020" y="379" text-anchor="middle" font-family="Inter, sans-serif" font-size="12" fill="white" fill-opacity="0.7">Semantic queries</text>
 
-  <rect x="854" y="487" width="262" height="18" rx="9" fill="#173E4D" fill-opacity="0.84"/>
-  <text x="985" y="500" text-anchor="middle" font-family="'Inter', 'Helvetica Neue', Arial, sans-serif" font-size="11" font-weight="600" fill="#D6E7EE">Observability, analytics, and webhook delivery</text>
+  <!-- Footer -->
+  <text x="600" y="462" text-anchor="middle" font-family="Inter, sans-serif" font-size="12" font-weight="500" fill="white" fill-opacity="0.55">All systems read from and write to the world model - confidence propagates through every projection level</text>
 </svg>