@amigo-ai/platform-sdk 0.75.0 → 0.76.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -3229,6 +3229,31 @@ export interface paths {
3229
3229
  patch?: never;
3230
3230
  trace?: never;
3231
3231
  };
3232
+ "/v1/{workspace_id}/intake/files/{file_id}/status": {
3233
+ parameters: {
3234
+ query?: never;
3235
+ header?: never;
3236
+ path?: never;
3237
+ cookie?: never;
3238
+ };
3239
+ get?: never;
3240
+ put?: never;
3241
+ /**
3242
+ * Write Back Intake File Status
3243
+ * @description Advance a file's status from the async CDC job (P4).
3244
+ *
3245
+ * The job authenticates with the workspace's API key (Bearer) — the same
3246
+ * Databricks→platform-api path launch_dpc uses — so RLS scopes the update to
3247
+ * that workspace. Moves the row to its terminal verdict and records the
3248
+ * curated/cdc paths.
3249
+ */
3250
+ post: operations["write_back_intake_file_status_v1__workspace_id__intake_files__file_id__status_post"];
3251
+ delete?: never;
3252
+ options?: never;
3253
+ head?: never;
3254
+ patch?: never;
3255
+ trace?: never;
3256
+ };
3232
3257
  "/v1/{workspace_id}/intake/links": {
3233
3258
  parameters: {
3234
3259
  query?: never;
@@ -6730,6 +6755,26 @@ export interface paths {
6730
6755
  patch?: never;
6731
6756
  trace?: never;
6732
6757
  };
6758
+ "/v1/{workspace_id}/traces:export": {
6759
+ parameters: {
6760
+ query?: never;
6761
+ header?: never;
6762
+ path?: never;
6763
+ cookie?: never;
6764
+ };
6765
+ get?: never;
6766
+ put?: never;
6767
+ /**
6768
+ * Export gen_ai.* traces as OTLP/JSON
6769
+ * @description Export the workspace's durable ``gen_ai.*`` tool-call trace spans over a time window as OpenTelemetry Protocol (OTLP/HTTP JSON) spans. Read-only; admin/owner role required; dark behind ``OTEL_TRACE_EXPORT_ENABLED`` (404 when off). Paginated PULL API — extract ``.resourceSpans`` before forwarding to an OTLP collector. Attributes are an allowlist of tool-call metadata; the raw tool-result ``error`` text is NOT exported (PHI-safe by construction).
6770
+ */
6771
+ post: operations["export_traces_v1__workspace_id__traces_export_post"];
6772
+ delete?: never;
6773
+ options?: never;
6774
+ head?: never;
6775
+ patch?: never;
6776
+ trace?: never;
6777
+ };
6733
6778
  "/v1/{workspace_id}/triggers": {
6734
6779
  parameters: {
6735
6780
  query?: never;
@@ -7708,6 +7753,61 @@ export interface components {
7708
7753
  /** Workspace Id */
7709
7754
  workspace_id?: string | null;
7710
7755
  };
7756
+ /**
7757
+ * ActorAllocatedEvent
7758
+ * @description The call was bound to its isolated runtime — one call = one Agones GameServer.
7759
+ *
7760
+ * Emitted by the dispatcher the moment it allocates a warm GameServer for the call,
7761
+ * so an observer can see WHICH pod/node powers this call and how long allocation took.
7762
+ */
7763
+ ActorAllocatedEvent: {
7764
+ /**
7765
+ * Alloc Latency Ms
7766
+ * @default null
7767
+ */
7768
+ alloc_latency_ms?: number | null;
7769
+ /** Gameserver */
7770
+ gameserver: string;
7771
+ /**
7772
+ * Node
7773
+ * @default null
7774
+ */
7775
+ node?: string | null;
7776
+ /**
7777
+ * @description discriminator enum property added by openapi-typescript
7778
+ * @enum {string}
7779
+ */
7780
+ type: "actor_allocated";
7781
+ };
7782
+ /**
7783
+ * ActorShutdownEvent
7784
+ * @description The call's GameServer was reaped (Allocated GameServers are deploy-immune).
7785
+ *
7786
+ * Today only ``reason=call_ended`` is produced (normal call-end teardown).
7787
+ * ``orphan_no_media`` is reserved in the contract for the orphan reaper — a pod that
7788
+ * went Allocated but never received media — but that emit is not yet wired: at reap
7789
+ * time the reaper pod has no call identity (allocation is cross-pod), so plumbing the
7790
+ * call_sid to it is a follow-up. The value is pre-declared so adding it later is a
7791
+ * non-breaking widening for SDK consumers, not a breaking enum change.
7792
+ */
7793
+ ActorShutdownEvent: {
7794
+ /**
7795
+ * Lifetime S
7796
+ * @default null
7797
+ */
7798
+ lifetime_s?: number | null;
7799
+ /**
7800
+ * Reason
7801
+ * @default call_ended
7802
+ * @enum {string}
7803
+ */
7804
+ reason?: "call_ended" | "orphan_no_media";
7805
+ /**
7806
+ * @description discriminator enum property added by openapi-typescript
7807
+ * @enum {string}
7808
+ */
7809
+ type: "actor_shutdown";
7810
+ };
7711
7811
  /** AddColumnAction */
7712
7812
  AddColumnAction: {
7713
7813
  column: components["schemas"]["Column-Input"];
@@ -7982,6 +8082,9 @@ export interface components {
7982
8082
  */
7983
8083
  workspace_id: string;
7984
8084
  };
8085
+ AnyValue: {
8086
+ [key: string]: unknown;
8087
+ };
7985
8088
  /** ApiKeyResponse */
7986
8089
  ApiKeyResponse: {
7987
8090
  /**
@@ -15316,6 +15419,13 @@ export interface components {
15316
15419
  */
15317
15420
  status: "delivered" | "queued_no_subscriber";
15318
15421
  };
15422
+ /** InstrumentationScope */
15423
+ InstrumentationScope: {
15424
+ /** Name */
15425
+ name: string;
15426
+ /** Version */
15427
+ version: string;
15428
+ };
15319
15429
  /**
15320
15430
  * IntakeFieldType
15321
15431
  * @description Allowed ``schema[].type`` values for a registered contract.
@@ -15886,6 +15996,15 @@ export interface components {
15886
15996
  */
15887
15997
  type: "latency_spike" | "silence" | "barge_in" | "loop" | "tool_failure" | "escalation" | "safety_flag" | "high_risk" | "elevated_risk";
15888
15998
  };
15999
+ /**
16000
+ * KeyValue
16001
+ * @description OTLP ``KeyValue`` attribute pair.
16002
+ */
16003
+ KeyValue: {
16004
+ /** Key */
16005
+ key: string;
16006
+ value: components["schemas"]["AnyValue"];
16007
+ };
15889
16008
  /** LLMConfig */
15890
16009
  LLMConfig: {
15891
16010
  experience_controls?: components["schemas"]["LLMExperienceControls"] | null;
@@ -16211,6 +16330,29 @@ export interface components {
16211
16330
  */
16212
16331
  workspace_id: string;
16213
16332
  };
16333
+ /**
16334
+ * MediaAttachedEvent
16335
+ * @description A media WebSocket actually reached the call's GameServer — the audio-path signal.
16336
+ *
16337
+ * Fires once per leg (caller / agent). Its ABSENCE for a leg is the no-audio failure
16338
+ * mode (media never landed on the pod). The per-call cold-start / time-to-first-speech
16339
+ * metric is deliberately NOT carried here yet: TTFS is measured against the first
16340
+ * synthesized-audio frame, a signal not available at attach time, so it is wired in a
16341
+ * focused follow-up (Front 3) rather than shipped as a permanently-null field that would
16342
+ * lock a misleading shape into the SDK contract.
16343
+ */
16344
+ MediaAttachedEvent: {
16345
+ /**
16346
+ * Leg
16347
+ * @enum {string}
16348
+ */
16349
+ leg: "caller" | "agent" | "operator";
16350
+ /**
16351
+ * @description discriminator enum property added by openapi-typescript
16352
+ * @enum {string}
16353
+ */
16354
+ type: "media_attached";
16355
+ };
16214
16356
  /** MergedEntitiesResponse */
16215
16357
  MergedEntitiesResponse: {
16216
16358
  /**
@@ -17056,7 +17198,7 @@ export interface components {
17056
17198
  */
17057
17199
  type: "oauth2_jwt_bearer";
17058
17200
  };
17059
- ObserverSSEEvent: components["schemas"]["AgentTranscriptDeltaEvent"] | components["schemas"]["AgentTranscriptEvent"] | components["schemas"]["BargeInEvent"] | components["schemas"]["CompoundEmotionEvent"] | components["schemas"]["EmotionEvent"] | components["schemas"]["EmpathyClassifiedEvent"] | components["schemas"]["ForwardCallResolvedEvent"] | components["schemas"]["LatencyEvent"] | components["schemas"]["NavTimingEvent"] | components["schemas"]["ParticipantJoinedEvent"] | components["schemas"]["ParticipantLeftEvent"] | components["schemas"]["SessionEndEvent"] | components["schemas"]["SessionInfoEvent"] | components["schemas"]["SessionStartEvent"] | components["schemas"]["SpeakerMutedEvent"] | components["schemas"]["StateTransitionEvent"] | components["schemas"]["ToolCallCompletedEvent"] | components["schemas"]["ToolCallStartedEvent"] | components["schemas"]["UserTranscriptEvent"] | components["schemas"]["VoiceContextAppliedEvent"];
17201
+ ObserverSSEEvent: components["schemas"]["ActorAllocatedEvent"] | components["schemas"]["ActorShutdownEvent"] | components["schemas"]["AgentTranscriptDeltaEvent"] | components["schemas"]["AgentTranscriptEvent"] | components["schemas"]["BargeInEvent"] | components["schemas"]["MediaAttachedEvent"] | components["schemas"]["CompoundEmotionEvent"] | components["schemas"]["EmotionEvent"] | components["schemas"]["EmpathyClassifiedEvent"] | components["schemas"]["ForwardCallResolvedEvent"] | components["schemas"]["LatencyEvent"] | components["schemas"]["NavTimingEvent"] | components["schemas"]["ParticipantJoinedEvent"] | components["schemas"]["ParticipantLeftEvent"] | components["schemas"]["SessionEndEvent"] | components["schemas"]["SessionInfoEvent"] | components["schemas"]["SessionStartEvent"] | components["schemas"]["SpeakerMutedEvent"] | components["schemas"]["StateTransitionEvent"] | components["schemas"]["ToolCallCompletedEvent"] | components["schemas"]["ToolCallStartedEvent"] | components["schemas"]["UserTranscriptEvent"] | components["schemas"]["VoiceContextAppliedEvent"];
17060
17202
  /** OcrRequest */
17061
17203
  OcrRequest: {
17062
17204
  /**
@@ -19429,6 +19571,17 @@ export interface components {
19429
19571
  /** Tool Type */
19430
19572
  tool_type: string;
19431
19573
  };
19574
+ /** Resource */
19575
+ Resource: {
19576
+ /** Attributes */
19577
+ attributes: components["schemas"]["KeyValue"][];
19578
+ };
19579
+ /** ResourceSpans */
19580
+ ResourceSpans: {
19581
+ resource: components["schemas"]["Resource"];
19582
+ /** Scopespans */
19583
+ scopeSpans: components["schemas"]["ScopeSpans"][];
19584
+ };
19432
19585
  /**
19433
19586
  * RestIntegrationResponse
19434
19587
  * @description REST variant — base URL, auth config, endpoint count.
@@ -20049,6 +20202,12 @@ export interface components {
20049
20202
  [key: string]: string;
20050
20203
  }[];
20051
20204
  };
20205
+ /** ScopeSpans */
20206
+ ScopeSpans: {
20207
+ scope: components["schemas"]["InstrumentationScope"];
20208
+ /** Spans */
20209
+ spans: components["schemas"]["Span"][];
20210
+ };
20052
20211
  /** ScoreSessionRequest */
20053
20212
  ScoreSessionRequest: {
20054
20213
  /** Score */
@@ -20358,7 +20517,7 @@ export interface components {
20358
20517
  /** Progress Vocabulary */
20359
20518
  progress_vocabulary?: string[] | null;
20360
20519
  /** Session Provider */
20361
- session_provider?: ("inhouse" | "openai_realtime") | null;
20520
+ session_provider?: ("inhouse" | "openai_realtime" | "atlas") | null;
20362
20521
  /** Transition Deadline Ms */
20363
20522
  transition_deadline_ms?: number | null;
20364
20523
  /** Tts Config */
@@ -20428,7 +20587,7 @@ export interface components {
20428
20587
  /** Progress Vocabulary */
20429
20588
  progress_vocabulary?: string[] | null;
20430
20589
  /** Session Provider */
20431
- session_provider?: ("inhouse" | "openai_realtime") | null;
20590
+ session_provider?: ("inhouse" | "openai_realtime" | "atlas") | null;
20432
20591
  /** Transition Deadline Ms */
20433
20592
  transition_deadline_ms?: number | null;
20434
20593
  /** Tts Config */
@@ -21913,6 +22072,27 @@ export interface components {
21913
22072
  */
21914
22073
  workspace_id: string;
21915
22074
  };
22075
+ /**
22076
+ * Span
22077
+ * @description OTLP ``Span`` in OTLP/JSON encoding (ids hex, timestamps decimal-string).
22078
+ */
22079
+ Span: {
22080
+ /** Attributes */
22081
+ attributes: components["schemas"]["KeyValue"][];
22082
+ /** Endtimeunixnano */
22083
+ endTimeUnixNano: string;
22084
+ /** Kind */
22085
+ kind: number;
22086
+ /** Name */
22087
+ name: string;
22088
+ /** Spanid */
22089
+ spanId: string;
22090
+ /** Starttimeunixnano */
22091
+ startTimeUnixNano: string;
22092
+ status: components["schemas"]["Status"];
22093
+ /** Traceid */
22094
+ traceId: string;
22095
+ };
21916
22096
  /** SpeakerAcoustics */
21917
22097
  SpeakerAcoustics: {
21918
22098
  /**
@@ -22136,6 +22316,29 @@ export interface components {
22136
22316
  /** Name */
22137
22317
  name: string;
22138
22318
  };
22319
+ /**
22320
+ * Status
22321
+ * @description OTLP ``Status`` — 0=UNSET, 1=OK, 2=ERROR.
22322
+ */
22323
+ Status: {
22324
+ /** Code */
22325
+ code: number;
22326
+ };
22327
+ /**
22328
+ * StatusWriteBackRequest
22329
+ * @description Status advance written by the async CDC job (P4).
22330
+ *
22331
+ * The job posts the terminal verdict after conform/validate/diff. ``error_reason``
22332
+ * must be PHI-safe (the engine reports column + type + counts only — never cell
22333
+ * values). ``curated_path``/``cdc_path`` are set only on a clean verdict.
22334
+ */
22335
+ StatusWriteBackRequest: {
22336
+ cdc_path?: components["schemas"]["_VolumePath"] | null;
22337
+ curated_path?: components["schemas"]["_VolumePath"] | null;
22338
+ /** Error Reason */
22339
+ error_reason?: string | null;
22340
+ status: components["schemas"]["_FileStatus"];
22341
+ };
22139
22342
  /** StepRequest */
22140
22343
  StepRequest: {
22141
22344
  /** Caller Text */
@@ -23826,6 +24029,52 @@ export interface components {
23826
24029
  */
23827
24030
  what_happened: string;
23828
24031
  };
24032
+ /** TracesExportRequest */
24033
+ TracesExportRequest: {
24034
+ /**
24035
+ * Continuation Token
24036
+ * @description Opaque page cursor — round-trip the value from the previous response.
24037
+ */
24038
+ continuation_token?: unknown;
24039
+ /**
24040
+ * End Time
24041
+ * Format: date-time
24042
+ * @description Exclusive upper bound on span ``effective_at`` (ISO-8601).
24043
+ */
24044
+ end_time: string;
24045
+ /**
24046
+ * Limit
24047
+ * @description Max spans per page (1-1000).
24048
+ * @default 500
24049
+ */
24050
+ limit?: number;
24051
+ /**
24052
+ * Start Time
24053
+ * Format: date-time
24054
+ * @description Inclusive lower bound on span ``effective_at`` (ISO-8601).
24055
+ */
24056
+ start_time: string;
24057
+ };
24058
+ /**
24059
+ * TracesExportResponse
24060
+ * @description Paginated PULL response — NOT a bare OTLP ``ExportTraceServiceRequest``.
24061
+ *
24062
+ * ``resourceSpans`` is OTLP/JSON-conformant; to forward to an OTLP collector,
24063
+ * extract ``.resourceSpans`` and re-wrap as ``{"resourceSpans": [...]}`` (a
24064
+ * strict protojson push receiver rejects the ``has_more``/``continuation_token``
24065
+ * siblings). Round-trip ``continuation_token`` to page.
24066
+ */
24067
+ TracesExportResponse: {
24068
+ /** Continuation Token */
24069
+ continuation_token?: unknown;
24070
+ /** Has More */
24071
+ has_more: boolean;
24072
+ /**
24073
+ * Resourcespans
24074
+ * @description OTLP/JSON ``ResourceSpans`` envelope (empty list when no spans match).
24075
+ */
24076
+ resourceSpans: components["schemas"]["ResourceSpans"][];
24077
+ };
23829
24078
  /** TranscriptSegment */
23830
24079
  TranscriptSegment: {
23831
24080
  /** Confidence */
@@ -25054,7 +25303,7 @@ export interface components {
25054
25303
  [key: string]: components["schemas"]["LanguageProviderEntry"];
25055
25304
  } | null;
25056
25305
  /** Session Provider */
25057
- session_provider?: ("inhouse" | "openai_realtime") | null;
25306
+ session_provider?: ("inhouse" | "openai_realtime" | "atlas") | null;
25058
25307
  /**
25059
25308
  * Similarity Boost
25060
25309
  * @default 0
@@ -25657,6 +25906,7 @@ export interface components {
25657
25906
  _ResourceType: "integration_endpoint" | "skill" | "kb_scope";
25658
25907
  _ToolMockKey: string;
25659
25908
  _ToolMockValue: string;
25909
+ _VolumePath: string;
25660
25910
  /**
25661
25911
  * Parameter
25662
25912
  * @description Typed declaration of one input parameter.
@@ -35158,6 +35408,42 @@ export interface operations {
35158
35408
  };
35159
35409
  };
35160
35410
  };
35411
+ write_back_intake_file_status_v1__workspace_id__intake_files__file_id__status_post: {
35412
+ parameters: {
35413
+ query?: never;
35414
+ header?: never;
35415
+ path: {
35416
+ workspace_id: string;
35417
+ file_id: string;
35418
+ };
35419
+ cookie?: never;
35420
+ };
35421
+ requestBody: {
35422
+ content: {
35423
+ "application/json": components["schemas"]["StatusWriteBackRequest"];
35424
+ };
35425
+ };
35426
+ responses: {
35427
+ /** @description Successful Response */
35428
+ 200: {
35429
+ headers: {
35430
+ [name: string]: unknown;
35431
+ };
35432
+ content: {
35433
+ "application/json": components["schemas"]["IntakeFileRow"];
35434
+ };
35435
+ };
35436
+ /** @description Validation Error */
35437
+ 422: {
35438
+ headers: {
35439
+ [name: string]: unknown;
35440
+ };
35441
+ content: {
35442
+ "application/json": components["schemas"]["HTTPValidationError"];
35443
+ };
35444
+ };
35445
+ };
35446
+ };
35161
35447
  "list-intake-links": {
35162
35448
  parameters: {
35163
35449
  query?: {
@@ -43502,6 +43788,41 @@ export interface operations {
43502
43788
  };
43503
43789
  };
43504
43790
  };
43791
+ export_traces_v1__workspace_id__traces_export_post: {
43792
+ parameters: {
43793
+ query?: never;
43794
+ header?: never;
43795
+ path: {
43796
+ workspace_id: string;
43797
+ };
43798
+ cookie?: never;
43799
+ };
43800
+ requestBody: {
43801
+ content: {
43802
+ "application/json": components["schemas"]["TracesExportRequest"];
43803
+ };
43804
+ };
43805
+ responses: {
43806
+ /** @description Successful Response */
43807
+ 200: {
43808
+ headers: {
43809
+ [name: string]: unknown;
43810
+ };
43811
+ content: {
43812
+ "application/json": components["schemas"]["TracesExportResponse"];
43813
+ };
43814
+ };
43815
+ /** @description Validation Error */
43816
+ 422: {
43817
+ headers: {
43818
+ [name: string]: unknown;
43819
+ };
43820
+ content: {
43821
+ "application/json": components["schemas"]["HTTPValidationError"];
43822
+ };
43823
+ };
43824
+ };
43825
+ };
43505
43826
  "list-triggers": {
43506
43827
  parameters: {
43507
43828
  query?: {