@proteos/sdk 0.60.0 → 0.75.0

package/dist/index.js

@@ -1,5 +1,5 @@
-import { AuditFieldsSchema, FileRefSchema, PrincipalRefSchema, AttributeSchema, UserRefSchema, PageIterator } from './chunk-OOOTPEJK.js';
-export { AppConfigurationSchema, AppHomeSchema, AppSchema, AttributeSchema, AuditFieldsSchema, CURRENT_USER, CURRENT_USER_DEFAULT, ColumnSchema, ComponentSchema, ContactAddressAttributeMetaSchema, CurrencyAttributeMetaSchema, DEFAULT_PAGE_SIZE, DONE, DesignReferenceSchema, EntityContactBindingSchema, EntityExtensionSchema, EntitySchema, EntityWithSchemaSchema, ExtensionPositionSchema, FileRefSchema, FilterElementSchema, FilterGroupSchema, ListExtensionColumnPlacementSchema, ListExtensionSchema, ListSchema, ListViewSchema, MENU_CONFIGURATION_EXTENSION_ANCHOR_ITEMS, MenuConfigurationExtensionPlacementSchema, MenuConfigurationExtensionPositionSchema, MenuConfigurationExtensionSchema, MenuConfigurationSchema, MenuItemSchema, MenuItemType, MetaClient, ModuleSchema, OnDeleteActionSchema, PAGE_EXTENSION_ANCHOR_MAIN, PAGE_EXTENSION_ANCHOR_SIDE_PANEL, PLATFORM_ATTRIBUTE_NAMES, PLATFORM_USER_ID, PageActionSchema, PageExtensionPlacementSchema, PageExtensionSchema, PageIterator, PageLayoutSchema, PageSchema, RelationAttributeMetaSchema, ResponseMetaSchema, SortConfigSchema, UserRefSchema, VariableSchema, acceptsCurrentUserDefault, allCurrencyCodes, createIterator, createListResultSchema, currencyLabel, currencySymbol, currencySymbolSide, formatAmount, formatMoney, isCurrentUser, isCurrentUserDefault, isPlatformAttributeName, localeNumberSeparators, parseAmount, parseContactAddressMeta, parseCurrencyMeta, parseFileMeta, parseRelationMeta, platformAttributes } from './chunk-OOOTPEJK.js';
+import { AuditFieldsSchema, FileRefSchema, PrincipalRefSchema, AttributeSchema, UserRefSchema, PageIterator } from './chunk-3VQQEJV6.js';
+export { AppConfigurationSchema, AppHomeSchema, AppSchema, AttributeSchema, AuditFieldsSchema, CURRENT_USER, CURRENT_USER_DEFAULT, ColumnSchema, ComponentSchema, ContactAddressAttributeMetaSchema, CurrencyAttributeMetaSchema, DEFAULT_PAGE_SIZE, DONE, DesignReferenceSchema, EntityContactBindingSchema, EntityExtensionSchema, EntitySchema, EntityWithSchemaSchema, ExtensionPositionSchema, FileRefSchema, FilterElementSchema, FilterGroupSchema, ListExtensionColumnPlacementSchema, ListExtensionSchema, ListSchema, ListViewSchema, MENU_CONFIGURATION_EXTENSION_ANCHOR_ITEMS, MenuConfigurationExtensionPlacementSchema, MenuConfigurationExtensionPositionSchema, MenuConfigurationExtensionSchema, MenuConfigurationSchema, MenuItemSchema, MenuItemType, MetaClient, ModuleSchema, OnDeleteActionSchema, PAGE_EXTENSION_ANCHOR_MAIN, PAGE_EXTENSION_ANCHOR_SIDE_PANEL, PLATFORM_ATTRIBUTE_NAMES, PLATFORM_USER_ID, PageActionSchema, PageExtensionPlacementSchema, PageExtensionSchema, PageIterator, PageLayoutSchema, PageSchema, RecordPageBindingSchema, RelationAttributeMetaSchema, ResponseMetaSchema, SortConfigSchema, TriggerPageBindingSchema, UserRefSchema, VariableSchema, acceptsCurrentUserDefault, allCurrencyCodes, bundleVersionOf, createIterator, createListResultSchema, currencyLabel, currencySymbol, currencySymbolSide, formatAmount, formatMoney, isCurrentUser, isCurrentUserDefault, isPlatformAttributeName, localeNumberSeparators, parseAmount, parseContactAddressMeta, parseCurrencyMeta, parseFileMeta, parseRelationMeta, platformAttributes } from './chunk-3VQQEJV6.js';
 import { z } from 'zod';
 import { fetchEventSource } from '@microsoft/fetch-event-source';
 
@@ -232,10 +232,11 @@ var SessionServiceImpl = class {
     for (const file of input.files ?? []) {
       content.push({ type: "file", ...file });
     }
+    const context = input.context?.trim();
     return this.appendEvent(id, {
       type: "user.message",
       ...input.turnId ? { turn_id: input.turnId } : {},
-      payload: { content }
+      payload: { content, ...context ? { context } : {} }
     });
   }
   async interrupt(id) {
@@ -582,7 +583,12 @@ var ErrorCode = {
   CONFLICT: "conflict",
   INTERNAL_SERVER_ERROR: "internal_server_error",
   INVALID_PAYLOAD: "invalid_payload",
-  INVALID_PERSONA: "invalid_persona"
+  INVALID_PERSONA: "invalid_persona",
+  /** The server was never reached: DNS, connection refused, network down.
+   *  Carried with httpStatus 0. */
+  NETWORK_ERROR: "network_error",
+  /** The request timed out client-side. Carried with httpStatus 0. */
+  REQUEST_TIMEOUT: "request_timeout"
 };
 var ProteosError = class extends Error {
   /** HTTP status code of the response */
@@ -987,12 +993,18 @@ var PLATFORM_ENTITIES = [
   { slug: "channel-events", name: "Channel Events" },
   // Conversation briefs: guidance prepared ahead of a conversation (call, meeting) with a contact.
   { slug: "conversation-briefs", name: "Conversation Briefs" },
+  // Conversation notes: what a person recorded about a conversation (append log, author-stamped).
+  { slug: "conversation-notes", name: "Conversation Notes" },
   // Conversation intelligence: the typed questions asked of conversations
   // (definitions), where/when they are evaluated (sets), and the observations
   // they produce incl. their evaluation history (tags).
   { slug: "conversation-tag-definitions", name: "Conversation Tag Definitions" },
   { slug: "conversation-tag-sets", name: "Conversation Tag Sets" },
   { slug: "conversation-tags", name: "Conversation Tags" },
+  // Conversation objectives: what a conversation should achieve (definitions)
+  // and each definition's standing per conversation (objectives, read-only ledger).
+  { slug: "conversation-objective-definitions", name: "Conversation Objective Definitions" },
+  { slug: "conversation-objectives", name: "Conversation Objectives" },
   // Connectors (connector-service). `connections` above is shared; this is the
   // manifest catalog.
   { slug: "connectors", name: "Connectors" },
@@ -1315,6 +1327,27 @@ var ProteosClient = class {
     }
     return AbortSignal.timeout(timeout);
   }
+  /**
+   * Runs fetch and turns a transport failure — DNS, connection refused, the
+   * network being down, the timeout signal firing — into a ProteosError with
+   * httpStatus 0, so callers can tell "the server said no" from "the server
+   * was never reached" (the latter is worth retrying). An abort the caller
+   * asked for is theirs and passes through untouched.
+   */
+  async send(url, init) {
+    try {
+      return await this.options.fetch(url, init);
+    } catch (error) {
+      if (error instanceof Error && error.name === "AbortError") throw error;
+      const message = error instanceof Error ? error.message : "Network request failed";
+      const isTimeout = error instanceof Error && (error.name === "TimeoutError" || error.message.startsWith("Request timeout"));
+      throw new ProteosError(
+        message,
+        0,
+        isTimeout ? ErrorCode.REQUEST_TIMEOUT : ErrorCode.NETWORK_ERROR
+      );
+    }
+  }
   /**
    * Performs an HTTP request and decodes the JSON response.
    *
@@ -1350,7 +1383,7 @@ var ProteosClient = class {
     }
     const headers = await this.buildHeaders(requestOptions);
     const signal = this.createTimeoutSignal(requestOptions);
-    const response = await this.options.fetch(url, {
+    const response = await this.send(url, {
       method,
       headers,
       body: body !== void 0 ? JSON.stringify(body) : null,
@@ -1398,7 +1431,7 @@ var ProteosClient = class {
       headers.set("Authorization", `Bearer ${token}`);
     }
     const signal = this.createTimeoutSignal(requestOptions);
-    const response = await this.options.fetch(url, {
+    const response = await this.send(url, {
       method,
       headers,
       body: formData,
@@ -1427,7 +1460,7 @@ var ProteosClient = class {
     const url = `${this.options.baseUrl}${path}`;
     const headers = await this.buildHeaders(requestOptions);
     const signal = this.createTimeoutSignal(requestOptions);
-    const response = await this.options.fetch(url, {
+    const response = await this.send(url, {
       method,
       headers,
       body: body !== void 0 ? JSON.stringify(body) : null,
@@ -1696,6 +1729,10 @@ var ConversationClient = class {
   conversationTagSets;
   /** Conversation intelligence: the observations produced + their evaluation history. */
   conversationTags;
+  /** Conversation objectives: WHAT a conversation should achieve (config, keyed, module-deployable). */
+  conversationObjectiveDefinitions;
+  /** Conversation objectives: the org-wide ledger of standings + grouped counts (read-only). */
+  conversationObjectives;
   /** Generic audience taxonomy; membership lives on the contact. */
   contactGroups;
   /** Tone-of-voice synthesis: per-user setups + the generated profiles. */
@@ -1703,13 +1740,17 @@ var ConversationClient = class {
   transcriptions;
   /** Review-pass findings: likely misheard terms awaiting accept/reject. */
   mistranscribedTerms;
-  /** Meeting bots (Ava): dispatch into a meeting URL, remove from a meeting. */
+  /** Meeting bots (Ava): dispatch into a meeting URL, summaries. */
   meetings;
+  /** Ava's bots as remembered by the platform: list them, withdraw her from a meeting. */
+  meetingBots;
   /** Realtime speech-to-text (dictation) — moved here from agent-service. */
   voice;
   calls;
   /** Conversation briefs: guidance prepared ahead of a conversation (call, meeting) with a contact. */
   conversationBriefs;
+  /** Conversation notes: what a person recorded about a conversation (append log, author-stamped). */
+  conversationNotes;
   constructor(client) {
     this.connections = new ConnectionServiceImpl(client);
     this.conversations = new ConversationServiceImpl(client);
@@ -1725,30 +1766,61 @@ var ConversationClient = class {
     this.conversationTagDefinitions = new ConversationTagDefinitionServiceImpl(client);
     this.conversationTagSets = new ConversationTagSetServiceImpl(client);
     this.conversationTags = new ConversationTagServiceImpl(client);
+    this.conversationObjectiveDefinitions = new ConversationObjectiveDefinitionServiceImpl(client);
+    this.conversationObjectives = new ConversationObjectiveServiceImpl(client);
     this.contactGroups = new ContactGroupServiceImpl(client);
     this.toneProfiles = new ToneProfileServiceImpl(client);
     this.transcriptions = new TranscriptionServiceImpl(client);
     this.mistranscribedTerms = new MistranscribedTermServiceImpl(client);
     this.meetings = new MeetingServiceImpl(client);
+    this.meetingBots = new MeetingBotServiceImpl(client);
     this.voice = new VoiceServiceImpl(client);
     this.calls = new CallServiceImpl(client);
     this.conversationBriefs = new ConversationBriefServiceImpl(client);
+    this.conversationNotes = new ConversationNoteServiceImpl(client);
   }
 };
-var MeetingServiceImpl = class {
+var ConversationNoteServiceImpl = class {
   constructor(client) {
     this.client = client;
   }
   client;
-  dispatch(request) {
-    return this.client.request("POST", `${CONVERSATION_BASE_PATH}/meetings`, request);
+  list(conversationId, query = {}) {
+    return this.client.requestWithQuery(
+      "GET",
+      `${CONVERSATION_BASE_PATH}/conversations/${encodeURIComponent(conversationId)}/notes`,
+      query
+    );
   }
-  remove(conversationId) {
+  create(conversationId, request) {
+    return this.client.request(
+      "POST",
+      `${CONVERSATION_BASE_PATH}/conversations/${encodeURIComponent(conversationId)}/notes`,
+      request
+    );
+  }
+  update(id, request) {
+    return this.client.request(
+      "PATCH",
+      `${CONVERSATION_BASE_PATH}/conversation-notes/${encodeURIComponent(id)}`,
+      request
+    );
+  }
+  delete(id) {
     return this.client.request(
       "DELETE",
-      `${CONVERSATION_BASE_PATH}/meetings/${encodeURIComponent(conversationId)}`
+      `${CONVERSATION_BASE_PATH}/conversation-notes/${encodeURIComponent(id)}`
     );
   }
+};
+var MeetingServiceImpl = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  dispatch(request) {
+    return this.client.request("POST", `${CONVERSATION_BASE_PATH}/meetings`, request);
+  }
   summarize(conversationId) {
     return this.client.request(
       "POST",
@@ -1756,6 +1828,21 @@ var MeetingServiceImpl = class {
     );
   }
 };
+var MeetingBotServiceImpl = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  list(query = {}) {
+    return this.client.requestWithQuery("GET", `${CONVERSATION_BASE_PATH}/meeting-bots`, query);
+  }
+  remove(id) {
+    return this.client.request(
+      "DELETE",
+      `${CONVERSATION_BASE_PATH}/meeting-bots/${encodeURIComponent(id)}`
+    );
+  }
+};
 var ConnectionServiceImpl = class {
   constructor(client) {
     this.client = client;
@@ -2010,6 +2097,19 @@ var ConversationServiceImpl = class {
       `${CONVERSATION_BASE_PATH}/conversations/${encodeURIComponent(id)}`
     );
   }
+  listOutcomes(id) {
+    return this.client.request(
+      "GET",
+      `${CONVERSATION_BASE_PATH}/conversations/${encodeURIComponent(id)}/outcomes`
+    );
+  }
+  async getObjectiveProgress(id) {
+    const response = await this.client.request(
+      "GET",
+      `${CONVERSATION_BASE_PATH}/conversations/${encodeURIComponent(id)}/objective-progress`
+    );
+    return response.data;
+  }
   update(id, request) {
     return this.client.request(
       "PATCH",
@@ -2371,6 +2471,12 @@ var ConversationTagServiceImpl = class {
       request
     );
   }
+  listApplicableDefinitions(conversationId) {
+    return this.client.request(
+      "GET",
+      `${CONVERSATION_BASE_PATH}/conversations/${encodeURIComponent(conversationId)}/tag-definitions`
+    );
+  }
   evaluate(conversationId, request = {}) {
     return this.client.request(
       "POST",
@@ -2409,6 +2515,75 @@ var ConversationTagServiceImpl = class {
     );
   }
 };
+var ConversationObjectiveDefinitionServiceImpl = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  list(query = {}) {
+    return this.listPage(query);
+  }
+  listPage(query = {}) {
+    return this.client.requestWithQuery(
+      "GET",
+      `${CONVERSATION_BASE_PATH}/conversation-objective-definitions`,
+      query
+    );
+  }
+  get(key) {
+    return this.client.request(
+      "GET",
+      `${CONVERSATION_BASE_PATH}/conversation-objective-definitions/${encodeURIComponent(key)}`
+    );
+  }
+  create(request) {
+    return this.client.request(
+      "POST",
+      `${CONVERSATION_BASE_PATH}/conversation-objective-definitions`,
+      request
+    );
+  }
+  update(key, request) {
+    return this.client.request(
+      "PATCH",
+      `${CONVERSATION_BASE_PATH}/conversation-objective-definitions/${encodeURIComponent(key)}`,
+      request
+    );
+  }
+  upsert(key, request) {
+    return this.client.request(
+      "PUT",
+      `${CONVERSATION_BASE_PATH}/conversation-objective-definitions/${encodeURIComponent(key)}`,
+      { ...request, key }
+    );
+  }
+  async delete(key) {
+    await this.client.request(
+      "DELETE",
+      `${CONVERSATION_BASE_PATH}/conversation-objective-definitions/${encodeURIComponent(key)}`
+    );
+  }
+};
+var ConversationObjectiveServiceImpl = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  list(query = {}) {
+    return this.client.requestWithQuery(
+      "GET",
+      `${CONVERSATION_BASE_PATH}/conversation-objectives`,
+      query
+    );
+  }
+  counts(query = {}) {
+    return this.client.requestWithQuery(
+      "GET",
+      `${CONVERSATION_BASE_PATH}/conversation-objectives/counts`,
+      query
+    );
+  }
+};
 var ContactGroupServiceImpl = class {
   constructor(client) {
     this.client = client;
@@ -2583,6 +2758,19 @@ var CallServiceImpl = class {
   mintToken(request) {
     return this.client.request("POST", `${CONVERSATION_BASE_PATH}/calls/token`, request);
   }
+  getCallConversation(connectionId, externalCallId) {
+    return this.client.request(
+      "GET",
+      `${CONVERSATION_BASE_PATH}/connections/${encodeURIComponent(connectionId)}/calls/${encodeURIComponent(externalCallId)}`
+    );
+  }
+  setRecording(conversationId, request) {
+    return this.client.request(
+      "PUT",
+      `${CONVERSATION_BASE_PATH}/conversations/${encodeURIComponent(conversationId)}/recording`,
+      request
+    );
+  }
   listPhoneNumbers(connectionId) {
     return this.client.request(
       "GET",
@@ -2755,6 +2943,42 @@ var ChannelEventServiceImpl = class {
   }
 };
 
+// src/data/entity-indexes.ts
+var ENTITIES_BASE_PATH = "/data/v1/entities";
+var EntityIndexServiceImpl = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  async list(entitySlug) {
+    const response = await this.client.request(
+      "GET",
+      `${ENTITIES_BASE_PATH}/${encodeURIComponent(entitySlug)}/indexes`
+    );
+    return response.data;
+  }
+  async recommendations(entitySlug) {
+    const response = await this.client.request(
+      "GET",
+      `${ENTITIES_BASE_PATH}/${encodeURIComponent(entitySlug)}/index-recommendations`
+    );
+    return response.data;
+  }
+  async create(entitySlug, request) {
+    return this.client.request(
+      "POST",
+      `${ENTITIES_BASE_PATH}/${encodeURIComponent(entitySlug)}/indexes`,
+      request
+    );
+  }
+  async delete(entitySlug, name) {
+    await this.client.request(
+      "DELETE",
+      `${ENTITIES_BASE_PATH}/${encodeURIComponent(entitySlug)}/indexes/${encodeURIComponent(name)}`
+    );
+  }
+};
+
 // src/data/queries.ts
 var QUERY_BASE_PATH = "/data/v1/query";
 var QueryServiceImpl = class {
@@ -2884,6 +3108,16 @@ var BatchUpsertTransactionResultSchema = z.object({
 var BatchUpsertRecordsResponseSchema = z.object({
   results: z.array(BatchUpsertTransactionResultSchema)
 });
+z.object({
+  name: z.string(),
+  type: z.enum(["lookup", "unique", "search"]),
+  attributes: z.array(z.string()),
+  source: z.enum(["declared", "automatic", "applied"]),
+  state: z.enum(["ready", "building", "invalid", "missing"]).optional(),
+  size_bytes: z.number().optional(),
+  scans: z.number().optional(),
+  created_at: z.string().optional()
+});
 
 // src/data/index.ts
 var DataClient = class {
@@ -2891,10 +3125,13 @@ var DataClient = class {
   queries;
   /** Duplicate pairs of an entity's records (raised by contact binding). */
   recordDuplicates;
+  /** Per-entity indexes on the record table + the advisor's recommendations. */
+  entityIndexes;
   constructor(client) {
     this.records = new RecordServiceImpl(client);
     this.queries = new QueryServiceImpl(client);
     this.recordDuplicates = new RecordDuplicateServiceImpl(client);
+    this.entityIndexes = new EntityIndexServiceImpl(client);
   }
 };