@amigo-ai/platform-sdk 0.39.0 → 0.41.0

package/api.md

@@ -149,6 +149,11 @@ All workspace-scoped resources also expose `withOptions(options)`.
 - `getAuditLog`
 - `getAuditLogAutoPaging`
 
+### `promptLogs`
+
+- `list`
+- `listAutoPaging`
+
 ### `triggers`
 
 - `list`

package/dist/index.cjs

@@ -1519,6 +1519,56 @@ var OperatorsResource = class extends WorkspaceScopedResource {
   }
 };
 
+// src/resources/prompt-logs.ts
+var PromptLogsResource = class extends WorkspaceScopedResource {
+  /**
+   * One page of prompt-log entries, newest-first.
+   *
+   * When ``params.conversation_id`` is supplied, the response surfaces
+   * ``resolved_call_sid`` (the call_sid the lookup mapped to) and
+   * ``resolved_conversation_kind`` (``"call"`` for voice/sim/scribe,
+   * ``"conversation"`` for text/sms/whatsapp/email) so you can drill
+   * into per-call surfaces afterward without re-querying
+   * ``world.entities``.
+   *
+   * When no selectivity-bearing filter is supplied (no conversation_id /
+   * call_sid / time range), the query is auto-capped to the last 7 days.
+   * The applied window is reported in ``applied_time_window_days``.
+   */
+  async list(params) {
+    return extractData(
+      await this.client.GET("/v1/{workspace_id}/prompt-logs", {
+        params: { path: { workspace_id: this.workspaceId }, query: params }
+      })
+    );
+  }
+  /**
+   * Auto-paginating async iterator over prompt-log entries. Walks
+   * ``next_offset`` until ``has_more`` is false, yielding individual
+   * entries. Use this when consuming logs at scale (e.g. nightly
+   * backfills) rather than rendering one page in a UI.
+   *
+   * Bounded by the same per-call hard caps as ``list`` (200 items per
+   * page, 10,000 cumulative offset).
+   */
+  async *listAutoPaging(params) {
+    let offset = 0;
+    while (true) {
+      const page = await this.list({ ...params, offset });
+      for (const entry of page.items) {
+        yield entry;
+      }
+      if (!page.has_more || page.next_offset == null) {
+        return;
+      }
+      if (page.next_offset === offset) {
+        return;
+      }
+      offset = page.next_offset;
+    }
+  }
+};
+
 // src/resources/triggers.ts
 var TriggersResource = class extends WorkspaceScopedResource {
   async list(params) {
@@ -6174,6 +6224,7 @@ var AmigoClient = class _AmigoClient {
   skills;
   actions;
   operators;
+  promptLogs;
   triggers;
   services;
   contextGraphs;
@@ -6315,6 +6366,7 @@ var AmigoClient = class _AmigoClient {
     mutable.skills = new SkillsResource(client, workspaceId2);
     mutable.actions = new ActionsResource(client, workspaceId2);
     mutable.operators = new OperatorsResource(client, workspaceId2);
+    mutable.promptLogs = new PromptLogsResource(client, workspaceId2);
     mutable.triggers = new TriggersResource(client, workspaceId2);
     mutable.services = new ServicesResource(client, workspaceId2);
     mutable.contextGraphs = new ContextGraphsResource(client, workspaceId2);