@proteos/sdk 0.26.3 → 0.28.0

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { A as AuditFields, L as ListOptions, a as Attribute, U as UserRef$2, P as PageIterator, b as ListResult, c as ProteosClient, F as FileRef, d as PublicAccessOperation } from './types-B0LqBATf.js';
-export { e as App, f as AppSchema, g as AppService, h as AttributeSchema, i as AttributeType, j as AuditFieldsSchema, C as ClientOptions, k as Column, l as ColumnSchema, m as ComparisonOperator, n as Component, o as ComponentSchema, p as ComponentService, q as CreateAppRequest, r as CreateComponentRequest, s as CreateDesignReferenceRequest, t as CreateEntityRequest, u as CreateListRequest, v as CreateListViewRequest, w as CreateMenuConfigurationRequest, x as CreatePageRequest, y as CreateVariableRequest, z as CurrencyAttributeMeta, B as CurrencyAttributeMetaSchema, D as CurrencySymbolSide, E as CurrencyValue, G as DEFAULT_OPTIONS, H as DEFAULT_PAGE_SIZE, I as DONE, J as DeployModuleRequest, K as DesignReference, M as DesignReferenceContent, N as DesignReferenceSchema, O as DesignReferenceService, Q as Done, R as Entity, S as EntitySchema, T as EntityService, V as EntityWithSchema, W as EntityWithSchemaSchema, X as FileAttributeMeta, Y as FileRefSchema, Z as FilterElement, _ as FilterElementSchema, $ as FilterGroup, a0 as FilterGroupSchema, a1 as List, a2 as ListAppsOptions, a3 as ListComponentsOptions, a4 as ListDesignReferencesOptions, a5 as ListEntitiesOptions, a6 as ListFn, a7 as ListListViewsOptions, a8 as ListListsOptions, a9 as ListMenuConfigurationsOptions, aa as ListModulesOptions, ab as ListPagesOptions, ac as ListSchema, ad as ListService, ae as ListVariablesOptions, af as ListView, ag as ListViewSchema, ah as ListViewService, ai as LogicalOperator, aj as MenuConfiguration, ak as MenuConfigurationSchema, al as MenuConfigurationService, am as MenuItem, an as MenuItemSchema, ao as MenuItemType, ap as MetaClient, aq as MetaListOptions, ar as Module, as as ModuleSchema, at as ModuleService, au as ModuleStatus, av as OnDeleteAction, aw as OnDeleteActionSchema, ax as PLATFORM_ATTRIBUTE_NAMES, ay as PLATFORM_USER_ID, az as Page, aA as PageAction, aB as PageActionSchema, aC as PageLayout, aD as PageLayoutSchema, aE as PageSchema, aF as PageService, aG as PageType, aH as PublicPageComponent, aI as PublicPageResponse, aJ as RelationAttributeMeta, aK as RelationAttributeMetaSchema, aL as RequestOptions, aM as ResolvedClientOptions, aN as ResponseMeta, aO as ResponseMetaSchema, aP as SortConfig, aQ as SortConfigSchema, aR as SortDirection, aS as Timestamps, aT as TokenProvider, aU as UpdateAppRequest, aV as UpdateComponentRequest, aW as UpdateDesignReferenceRequest, aX as UpdateEntityRequest, aY as UpdateListRequest, aZ as UpdateListViewRequest, a_ as UpdateMenuConfigurationRequest, a$ as UpdatePageRequest, b0 as UpdateVariableRequest, b1 as UserRefSchema, b2 as UserType, b3 as Variable, b4 as VariableSchema, b5 as VariableService, b6 as allCurrencyCodes, b7 as createIterator, b8 as createListResultSchema, b9 as currencyLabel, ba as currencySymbol, bb as currencySymbolSide, bc as formatAmount, bd as formatMoney, be as isPlatformAttributeName, bf as localeNumberSeparators, bg as parseAmount, bh as parseCurrencyMeta, bi as parseFileMeta, bj as parseRelationMeta, bk as platformAttributes, bl as resolveOptions } from './types-B0LqBATf.js';
+import { A as AuditFields, L as ListOptions, a as Attribute, U as UserRef$2, P as PageIterator, b as ListResult, c as ProteosClient, F as FileRef, d as PublicAccessOperation } from './types-BguERkVI.js';
+export { e as App, f as AppSchema, g as AppService, h as AttributeSchema, i as AttributeType, j as AuditFieldsSchema, C as ClientOptions, k as Column, l as ColumnSchema, m as ComparisonOperator, n as Component, o as ComponentSchema, p as ComponentService, q as CreateAppRequest, r as CreateComponentRequest, s as CreateDesignReferenceRequest, t as CreateEntityRequest, u as CreateListRequest, v as CreateListViewRequest, w as CreateMenuConfigurationRequest, x as CreatePageRequest, y as CreateVariableRequest, z as CurrencyAttributeMeta, B as CurrencyAttributeMetaSchema, D as CurrencySymbolSide, E as CurrencyValue, G as DEFAULT_OPTIONS, H as DEFAULT_PAGE_SIZE, I as DONE, J as DeployModuleRequest, K as DesignReference, M as DesignReferenceContent, N as DesignReferenceSchema, O as DesignReferenceService, Q as Done, R as Entity, S as EntitySchema, T as EntityService, V as EntityWithSchema, W as EntityWithSchemaSchema, X as FileAttributeMeta, Y as FileRefSchema, Z as FilterElement, _ as FilterElementSchema, $ as FilterGroup, a0 as FilterGroupSchema, a1 as List, a2 as ListAppsOptions, a3 as ListComponentsOptions, a4 as ListDesignReferencesOptions, a5 as ListEntitiesOptions, a6 as ListFn, a7 as ListListViewsOptions, a8 as ListListsOptions, a9 as ListMenuConfigurationsOptions, aa as ListModulesOptions, ab as ListPagesOptions, ac as ListSchema, ad as ListService, ae as ListVariablesOptions, af as ListView, ag as ListViewSchema, ah as ListViewService, ai as LogicalOperator, aj as MenuConfiguration, ak as MenuConfigurationSchema, al as MenuConfigurationService, am as MenuItem, an as MenuItemSchema, ao as MenuItemType, ap as MetaClient, aq as MetaListOptions, ar as Module, as as ModuleSchema, at as ModuleService, au as ModuleStatus, av as OnDeleteAction, aw as OnDeleteActionSchema, ax as PLATFORM_ATTRIBUTE_NAMES, ay as PLATFORM_USER_ID, az as Page, aA as PageAction, aB as PageActionSchema, aC as PageLayout, aD as PageLayoutSchema, aE as PageSchema, aF as PageService, aG as PageType, aH as PublicPageComponent, aI as PublicPageResponse, aJ as RelationAttributeMeta, aK as RelationAttributeMetaSchema, aL as RequestOptions, aM as ResolvedClientOptions, aN as ResponseMeta, aO as ResponseMetaSchema, aP as SortConfig, aQ as SortConfigSchema, aR as SortDirection, aS as Timestamps, aT as TokenProvider, aU as UpdateAppRequest, aV as UpdateComponentRequest, aW as UpdateDesignReferenceRequest, aX as UpdateEntityRequest, aY as UpdateListRequest, aZ as UpdateListViewRequest, a_ as UpdateMenuConfigurationRequest, a$ as UpdatePageRequest, b0 as UpdateVariableRequest, b1 as UserRefSchema, b2 as UserType, b3 as Variable, b4 as VariableSchema, b5 as VariableService, b6 as allCurrencyCodes, b7 as createIterator, b8 as createListResultSchema, b9 as currencyLabel, ba as currencySymbol, bb as currencySymbolSide, bc as formatAmount, bd as formatMoney, be as isPlatformAttributeName, bf as localeNumberSeparators, bg as parseAmount, bh as parseCurrencyMeta, bi as parseFileMeta, bj as parseRelationMeta, bk as platformAttributes, bl as resolveOptions } from './types-BguERkVI.js';
 import { z } from 'zod';
 
 /**
@@ -2045,12 +2045,15 @@ interface UserRef {
 }
 /**
  * Inline snapshot of a person on a message/reaction — the integration-side
- * identity plus, when resolved via email match, the platform user.
+ * identity plus, when resolved, the platform user and the contact id.
+ * (Renamed from ParticipantRef in the contacts model; wire keys unchanged.)
  */
-interface ParticipantRef {
+interface ContactRef {
     external_id?: string;
     name: string;
     email?: string;
+    /** The resolved person; absent on pre-contacts snapshots and wire fallbacks. */
+    contact_id?: string;
     /** Resolved platform identity (email match); absent when unresolved. */
     platform_user?: UserRef;
 }
@@ -2060,7 +2063,7 @@ interface ParticipantRef {
  * renders "who it's with" as the non-self subset (1 → single avatar, ≥2 →
  * stacked).
  */
-interface ConversationParticipant extends ParticipantRef {
+interface ConversationParticipant extends ContactRef {
     is_self: boolean;
 }
 /** How a MessageRecipient was addressed: primary, carbon copy, blind copy. */
@@ -2069,7 +2072,7 @@ type RecipientRole = 'to' | 'cc' | 'bcc';
  * One addressee of a message with the role it was addressed under. Bcc is only
  * present on messages the platform itself sent (inbound bcc is SMTP-stripped).
  */
-interface MessageRecipient extends ParticipantRef {
+interface MessageRecipient extends ContactRef {
     role: RecipientRole;
 }
 /**
@@ -2126,7 +2129,7 @@ interface Connection {
     scope: ConnectionScope;
     /** Set only when scope=user (the connecting user); absent for org-wide. */
     owner?: UserRef;
-    external_workspace_id: string;
+    external_account_id: string;
     credentials: ConnectionCredentials;
     settings: Record<string, unknown>;
     status: ConnectionStatus;
@@ -2193,7 +2196,7 @@ interface Conversation {
     latest_message?: MessagePreview;
     messages_total?: number;
     /** Up to 3 most recent distinct senders excluding the root sender. */
-    last_repliers?: ParticipantRef[];
+    last_repliers?: ContactRef[];
     /** Requesting user's read marker; absent = never opened. */
     last_read_at?: string;
     /**
@@ -2212,7 +2215,7 @@ interface Conversation {
  * ~500 chars of text, direction/status for outbound identity.
  */
 interface MessagePreview {
-    sender: ParticipantRef;
+    sender: ContactRef;
     text: string;
     direction: MessageDirection;
     status: MessageStatus;
@@ -2247,7 +2250,7 @@ interface Attachment {
 interface Reaction {
     emoji: string;
     count: number;
-    participants: ParticipantRef[];
+    participants: ContactRef[];
 }
 interface Message {
     id: string;
@@ -2257,7 +2260,7 @@ interface Message {
     channel: Channel;
     direction: MessageDirection;
     external_message_id: string;
-    sender: ParticipantRef;
+    sender: ContactRef;
     /** Who the message was addressed to (To/Cc/Bcc), each tagged with its role. */
     recipients?: MessageRecipient[];
     content: ContentBlock[];
@@ -2474,7 +2477,8 @@ interface ListConversationsQuery extends PaginationQuery {
      */
     parent_conversation_id?: string;
     /** Threads whose roster contains this external party — the person stream. */
-    participant_external_id?: string;
+    /** Contact stream: threads whose roster contains the resolved person. */
+    contact_id?: string;
     /** Opt into the root/latest message projection on each row. */
     include?: 'messages_summary';
 }
@@ -2499,38 +2503,112 @@ interface ListAgentListenersQuery extends PaginationQuery {
     agent_key?: string;
     is_enabled?: boolean;
 }
-/** Discriminates a send target: a person or a venue. */
-type RecipientKind = 'participant' | 'room';
-type ParticipantSource = 'sync' | 'ingest';
+/**
+ * Discriminates a send target: a person's contact address or a venue. The
+ * server also accepts the legacy 'participant' value as an alias for
+ * 'contact-address'.
+ */
+type RecipientKind = 'contact-address' | 'room';
+type ContactAddressKind = 'email' | 'phone' | 'slack' | 'linkedin' | 'telegram' | 'instagram' | 'messenger' | 'x' | 'whatsapp';
+type ContactAddressSource = 'sync' | 'ingest' | 'manual' | 'merge';
+type ContactSource = 'sync' | 'ingest' | 'manual' | 'merge';
+type ContactStatus = 'active' | 'merged' | 'archived' | 'erased';
+type ConsentStatus = 'unknown' | 'opted_in' | 'opted_out';
+type PermissionEventType = 'opt_in' | 'opt_out' | 'block' | 'unblock';
+type PermissionEventSource = 'manual' | 'import' | 'link_click' | 'reply' | 'api' | 'system';
+type MergeProposalStatus = 'proposed' | 'approved' | 'rejected' | 'superseded';
+type ErasureRequestStatus = 'requested' | 'completed';
 type RoomSource = 'sync' | 'ingest';
 /**
  * Send-time addressing VO: who/where an originated message goes. Points at a
- * Participant or a Room by kind + external id (never a stored entity itself).
+ * ContactAddress or a Room by kind + external id (never a stored entity itself).
  */
 interface SendRecipient {
     kind: RecipientKind;
-    /** The connector-side id: a room's (Slack channel id) or a participant's (Slack user id, email address). */
+    /** The connector-side id: a room's (Slack channel id) or a contact address's wire identifier (Slack user id, email address). */
     external_id: string;
 }
-/** A PERSON known on a connection (directory row; resolvable to a platform user). */
-interface Participant {
+/** The actual PERSON an org communicates with — org-scoped, channel-agnostic. */
+interface Contact {
     id: string;
     org_id: string;
-    connection_id: string;
-    /** Slack user id / email address — the id to DM or email. */
-    external_id: string;
     name: string;
-    email?: string;
-    /** Resolved platform identity (email match); absent when unresolved. */
+    status: ContactStatus;
+    /** Person-level suppression — only block/unblock events move it. */
+    is_blocked: boolean;
+    has_legal_hold: boolean;
+    consent_status: ConsentStatus;
+    consent_updated_at?: string;
+    /** Resolved platform identity when the person is a colleague. */
     platform_user?: UserRef;
+    /** Merge tombstone redirect (set when status is 'merged'). */
+    merged_into_contact_id?: string;
+    source: ContactSource;
+    has_manual_edits: boolean;
+    /** The contact's reachable endpoints, embedded on reads. */
+    addresses?: ContactAddress[];
+    created_at: string;
+    created_by: UserRef;
+    updated_at: string;
+    updated_by: UserRef;
+}
+/** ONE canonical digital endpoint to reach a contact — the dedup backbone. */
+interface ContactAddress {
+    id: string;
+    org_id: string;
+    contact_id: string;
+    kind: ContactAddressKind;
+    /** Provider-tenant qualifier (Slack workspace id); empty for global kinds. */
+    scope?: string;
+    /** Canonical scalar (lowercased email, E.164 phone) — the lookup key. */
+    value: string;
+    /** The identifier as observed on the wire (WhatsApp JID, original casing). */
+    raw_value?: string;
+    /** Per-channel display name. */
+    name: string;
+    consent_status: ConsentStatus;
+    consent_updated_at?: string;
+    is_blocked: boolean;
+    source: ContactAddressSource;
     metadata: Record<string, unknown>;
-    source: ParticipantSource;
-    last_seen_at: string;
     created_at: string;
     created_by: UserRef;
     updated_at: string;
     updated_by: UserRef;
 }
+/** One candidate duplicate pair awaiting review. */
+interface ContactMergeProposal {
+    id: string;
+    org_id: string;
+    contact_a_id: string;
+    contact_b_id: string;
+    suggested_winner_id?: string;
+    confidence?: number;
+    evidence?: Record<string, unknown>;
+    verdict?: Record<string, unknown>;
+    status: MergeProposalStatus;
+    resolved_by?: UserRef;
+    resolved_at?: string;
+    created_at: string;
+    created_by: UserRef;
+    updated_at: string;
+    updated_by: UserRef;
+}
+/** A GDPR Art. 17 erasure request (requested → completed). */
+interface ContactErasureRequest {
+    id: string;
+    org_id: string;
+    contact_id: string;
+    identifier_hashes: Array<{
+        kind: ContactAddressKind;
+        hmac: string;
+    }>;
+    status: ErasureRequestStatus;
+    completed_at?: string;
+    stats?: Record<string, unknown>;
+    created_at: string;
+    created_by: UserRef;
+}
 /** An addressable VENUE on a connection (Slack channel; later meeting rooms). */
 interface Room {
     id: string;
@@ -2548,9 +2626,46 @@ interface Room {
     updated_at: string;
     updated_by: UserRef;
 }
-interface ListParticipantsQuery extends PaginationQuery {
-    /** Free-text needle matched against display name + external id. */
+interface ListContactAddressesQuery extends PaginationQuery {
+    /** Free-text needle matched against display name + canonical value. */
+    q?: string;
+    kinds?: ContactAddressKind[];
+    scope?: string;
+}
+interface ListContactsQuery extends PaginationQuery {
+    /** Free-text needle matched against contact name + address values. */
     q?: string;
+    status?: ContactStatus;
+}
+interface UpdateContactRequest {
+    name?: string;
+    status?: 'active' | 'archived';
+    has_legal_hold?: boolean;
+}
+interface AttachContactAddressRequest {
+    kind: ContactAddressKind;
+    scope?: string;
+    value: string;
+    name?: string;
+}
+interface MergeContactsRequest {
+    source_contact_id: string;
+}
+interface RecordPermissionEventRequest {
+    contact_address_id?: string;
+    event: PermissionEventType;
+    basis?: string;
+    source?: PermissionEventSource;
+    occurred_at?: string;
+    note?: string;
+    evidence?: Record<string, unknown>;
+}
+interface BlockContactRequest {
+    contact_address_id?: string;
+    note?: string;
+}
+interface ListContactMergeProposalsQuery extends PaginationQuery {
+    status?: MergeProposalStatus;
 }
 interface ListRoomsQuery extends PaginationQuery {
     /** Free-text needle matched against name + external id. */
@@ -2648,6 +2763,8 @@ interface DispatchMeetingBotRequest {
 declare class ConversationClient {
     readonly connections: ConnectionService;
     readonly conversations: ConversationService;
+    /** The person-level identity layer: contacts, addresses, merges, permissions. */
+    readonly contacts: ContactService;
     readonly messages: MessageService;
     readonly agentListeners: AgentListenerService;
     /** Per-org glossary: custom vocabulary that boosts transcription accuracy. */
@@ -2686,11 +2803,29 @@ interface ConnectionService {
     delete(id: string): Promise<void>;
     /** Begin the connector's install flow; open the returned URL in a popup. */
     install(id: string): Promise<InstallConnectionResponse>;
-    /** Search a connection's known PEOPLE (workspace members, correspondents) for the compose picker. */
-    listParticipants(connectionId: string, query?: ListParticipantsQuery): Promise<ListResponse<Participant>>;
+    /** Search the contact addresses this connection can reach (org-deduped) for the compose picker. */
+    listContactAddresses(connectionId: string, query?: ListContactAddressesQuery): Promise<ListResponse<ContactAddress>>;
     /** Search a connection's addressable VENUES (Slack channels) for the compose picker. */
     listRooms(connectionId: string, query?: ListRoomsQuery): Promise<ListResponse<Room>>;
 }
+/** The person-level identity layer: contacts, addresses, merges, permissions, erasure. */
+interface ContactService {
+    list(query?: ListContactsQuery): Promise<ListResponse<Contact>>;
+    get(id: string): Promise<Contact>;
+    update(id: string, request: UpdateContactRequest): Promise<Contact>;
+    attachAddress(contactId: string, request: AttachContactAddressRequest): Promise<Contact>;
+    detachAddress(contactId: string, addressId: string): Promise<Contact>;
+    /** Fold source_contact_id into contactId (contactId wins). */
+    merge(contactId: string, request: MergeContactsRequest): Promise<Contact>;
+    recordPermissionEvent(contactId: string, request: RecordPermissionEventRequest): Promise<Contact>;
+    block(contactId: string, request?: BlockContactRequest): Promise<Contact>;
+    unblock(contactId: string, request?: BlockContactRequest): Promise<Contact>;
+    requestErasure(contactId: string): Promise<ContactErasureRequest>;
+    listErasureRequests(contactId: string): Promise<ContactErasureRequest[]>;
+    listMergeProposals(query?: ListContactMergeProposalsQuery): Promise<ListResponse<ContactMergeProposal>>;
+    approveMergeProposal(proposalId: string): Promise<ContactMergeProposal>;
+    rejectMergeProposal(proposalId: string): Promise<ContactMergeProposal>;
+}
 /** Conversation threads across every channel (inbox order: last_message_at). */
 interface ConversationService {
     list(query?: ListConversationsQuery): Promise<ListResponse<Conversation>>;
@@ -4722,11 +4857,15 @@ interface FileService {
      */
     create(metadata: CreateFileMetadata): Promise<StorageFile>;
     /**
-     * Updates a file's metadata (name, `public_access`). Only the fields present
-     * in `metadata` are changed. Setting `public_access: ["read"]` exposes the
-     * file on the UNAUTHENTICATED public download route; `[]` revokes it.
+     * Updates a file's metadata (name, `public_access`) and, when `file` is
+     * given, replaces the bytes IN PLACE — a new version under the SAME id, so
+     * every `FileRef { id }` pointing at it now resolves to the new content.
+     * Only the metadata fields present are changed. Setting
+     * `public_access: ["read"]` exposes the file on the UNAUTHENTICATED public
+     * download route; `[]` revokes it. Replacing a locked file is rejected by
+     * the storage-service.
      */
-    update(id: string, metadata: UpdateFileMetadata): Promise<StorageFile>;
+    update(id: string, metadata: UpdateFileMetadata, file?: File): Promise<StorageFile>;
     /**
      * Mints a short-lived upload URL for a file. The bytes are PUT directly to this URL
      * (raw body, no auth) — keeping large files off the SDK/MCP path. Single-use, ~3 min.
@@ -5445,4 +5584,4 @@ declare class WorkflowClient {
     constructor(client: ProteosClient);
 }
 
-export { AccountClient, type Action, type ActionBinding, ActionSchema, type ActionScope, ActionScopeSchema, type ActionService, type Agent, type AgentActionParams, type AgentArtifactsPayload, AgentClient, type AgentKickoff, type AgentListener, type AgentListenerService, type AgentListenerTriggerType, type AgentMessagePayload, type AgentResourceListOptions, type AgentService, type ApiErrorResponse, type AppendEventRequest, type AssignPermissionRequest, type AssignRoleRequest, type Attachment, Attribute, AuditFields, type AuthListOptions, type BatchTransactionError, BatchTransactionErrorSchema, type BatchTransactionStatus, type BatchUpsertRecordsResponse, BatchUpsertRecordsResponseSchema, type BatchUpsertTransaction, type BatchUpsertTransactionResult, BatchUpsertTransactionResultSchema, BatchUpsertTransactionSchema, type BinaryRef, type Channel, type ClientEventType, type ClientToolSchema, type Connection, type ConnectionCredentials, type ConnectionEndpoint, type ConnectionScope, type ConnectionService, type ConnectionStatus, type Connector, ConnectorClient, type ConnectorConnection, type ConnectionScope$1 as ConnectorConnectionScope, type ConnectionStatus$1 as ConnectorConnectionStatus, type ConnectionTokenResponse as ConnectorConnectionTokenResponse, type CredentialKind as ConnectorCredentialKind, type ConnectorKey, type ConnectorMethod, type ConnectorProvider, type ConsumerGroup, type ContentBlock$1 as ContentBlock, type ContentMatch, type ContentResponse, type ContextCompactedPayload, type Conversation, ConversationClient, type ConversationParticipant, type ConversationService, type ConversationStatus, type CreateAgentListenerRequest, type CreateAgentRequest, type CreateConnectionRequest, type CreateConnectorConnectionRequest, type CreateFileMetadata, type CreateGlossaryTermRequest, type CreateLabelRequest, type CreateLinkRequest, type CreateMcpServerRequest, type CreateNodeRequest, type CreateOrganizationRequest, type CreatePromptRequest, type CreateRecordLinkRequest, type CreateRoleRequest, type CreateSessionRequest, type CreateToolRequest, type CreateUserRequest, type CreateWorkflowRequest, type CredentialSpec, type CronTriggerParams, DEFAULT_PORT, DataClient, type DispatchMeetingBotRequest, type DisplayOptions, ERROR_PORT, type EditContentRequest, type EditContentResponse, type EmptyPayload, ErrorCode, type ErrorCodeType, type ErrorPayload, type EventTriggerParams, type EventType, type EventVerb, EventsClient, type ExecutionError, type ExecutionStatus, type ExecutionTriggerContext, type FileBlock, FileRef, type FileService, type FileVersionContent, FunctionsClient, type GetExecutionDetailResponse, type GetGraphOptions, type GetNodeExecutionItemsOptions, type GetNodeExecutionItemsResponse, type GetNodeTypesResponse, type GlossaryTerm, type GlossaryTermService, type GraphService, type InlineLinkRequest, type InstallConnectionResponse, type InstallConnectorConnectionResponse, type InvokeActionResponse, type InvokeNodeMethodRequest, type InvokeNodeMethodResponse, type Item, type KickoffSource, type KickoffType, KnowledgeClient, type KnowledgeGraph, type KnowledgeGraphLink, type KnowledgeGraphNode, type KnowledgeLabel, KnowledgeLabelSchema, type KnowledgeLink, KnowledgeLinkSchema, type KnowledgeNode, type KnowledgeNodeLabel, KnowledgeNodeLabelSchema, type KnowledgeNodeMetadata, KnowledgeNodeMetadataSchema, KnowledgeNodeSchema, type KnowledgeNodeSearchResult, KnowledgeNodeSearchResultSchema, type KnowledgeRecordLink, KnowledgeRecordLinkSchema, type LabelService, type LinkService, type LinkType, type ListActionsOptions, type ListAgentListenersQuery, type ListAgentsOptions, type ListConnectionsQuery, type ListConnectorConnectionsQuery, type ListConnectorsQuery, type ListConversationsQuery, type ListEventsOptions, type ListExecutionsOptions, type ListGlossaryTermsQuery, type ListLabelsOptions, type ListLinksOptions, type ListMcpServersOptions, type ListMessagesQuery, type ListNodesOptions, ListOptions, type ListOrganizationsOptions, type ListParticipantsQuery, type ListPromptsOptions, type ListRecordLinksOptions, type ListRecordsOptions, type ListResponse, ListResult, type ListRolePermissionsOptions, type ListRolesOptions, type ListRoomsQuery, type ListSessionsOptions, type ListSkillsOptions, type ListToolsOptions, type ListUserRoleAssignmentsOptions, type ListUsersOptions, type ListWorkflowsOptions, type ManualTriggerParams, type MatchMode, type McpBinding, type McpConnectionState, type McpConnectionStatus, type McpServer, type McpServerAuth, type McpServerOAuth, type McpServerService, type McpToolSummary, type MeService, type MeetingService, type Message, type ContentBlock as MessageContentBlock, type MessageDirection, type MessageKickoff, type MessagePreview, type MessageRecipient, type MessageService, type MessageStatus, type MessageTriggerParams, type ModelConfig, type ModelRequestEndPayload, type ModelRequestStartPayload, type ModelUsage, type NeighborDirection, type NeighborEdge, type NeighborNode, type NeighborsOptions, type NodeContentMatches, type NodeDescriptor, type NodeExecution, type NodeGroup, type NodeMethodOption, type NodeNeighborhood, NodeNeighborhoodSchema, type NodeOutline, type NodePosition, type NodeProperty, type NodeRetryPolicy, type NodeRuntime, type NodeService, type NodeStatus, type NodeType, type NodeTypeKey, type NodeTypeService, type NodeTypeStatus, type OnErrorPolicy, type Organization, OrganizationSchema, type OrganizationService, type OutcomeKickoff, type OutcomeRubric, type OutlineHeading, type OutlineRequest, type OutlineResponse, PLATFORM_ENTITIES, PLATFORM_ENTITY_SLUGS, PageIterator, type PairedItem, type ParseStatus, type Participant, type ParticipantRef, type ParticipantSource, type Permission, type PlatformEntity, type PlatformEvent, type PortSpec, type Prompt, type PromptService, type PromptVersion, type PropertyOption, type PropertyType, ProteosClient, ProteosError, PublicAccessOperation, type PublishEventRequest, type QueryExecuteMeta, type QueryExecuteResponse, type QueryObject, type QueryRow, type QueryService, type QueryValidateMeta, type QueryValidateResponse, type QueryValue, type Reaction, type ReactionCapability, type ReactionOption, type ReactionSetKind, type ReasoningPayload, type RecipientKind, type RecipientRole, type RecordData, type RecordLinkService, type RecordService, type RedriveResult, type ResultBlock, type Role, type RoleEntityPermission, RoleEntityPermissionSchema, RoleSchema, type RoleService, type Room, type RunWorkflowRequest, type SearchContentRequest, type SearchContentResponse, type SearchNodesRequest, type SendMessageRequest, type SendRecipient, type Session, type SessionEvent, type SessionEventEnvelope, type SessionEventsOptions, type SessionIdlePayload, type SessionService, type SessionStatus, type SessionStreamOptions, type SessionUpdatedPayload, type Skill, type SkillBundle, type SkillService, type SkillVersion, type StartMcpOAuthResponse, type StopReason, StorageClient, type StorageFile, type StorageFileVersion, type TailOptions, type TestNodeCandidate, type TestNodeInputSource, type TestNodeRequest, type TestNodeResponse, type TextBlock, type Tool, type ToolBinding, type ToolConfirmationPayload, type ToolKind, type ToolResultPayload, type ToolService, type ToolUsePayload, type Topic, type TopicKind, type TopicService, type TranscribeStreamOptions, type TranscriptResult, type TriggerKind, type Turn, type UnreadCounts, type UpdateAgentListenerRequest, type UpdateAgentRequest, type UpdateConnectionRequest, type UpdateConnectorConnectionRequest, type UpdateFileMetadata, type UpdateGlossaryTermRequest, type UpdateLabelRequest, type UpdateLinkRequest, type UpdateMcpServerRequest, type UpdateNodeRequest, type UpdateOrganizationRequest, type UpdatePromptRequest, type UpdateRoleRequest, type UpdateToolRequest, type UpdateUserRequest, type UpdateWorkflowRequest, type User, type UserMessagePayload, UserRef$2 as UserRef, type UserRoleAssignment, UserRoleAssignmentSchema, UserSchema, type UserService, type VoiceService, type VoiceTranscriptionStream, type WebhookTriggerParams, type Workflow, WorkflowClient, type WorkflowConnection, type WorkflowContentBlock, type WorkflowExecution, type WorkflowGraph, type WorkflowNode, type WorkflowNodeType, type WorkflowStatus, type WorkflowVersion, type WorkflowVersionAuthor, type WorkflowVersionSummary, type WriteContentResponse, type WriteCredentialsRequest, buildUrl, getDefaultErrorCode, isBadRequest, isConflict, isForbidden, isNotFound, isPlatformEntity, isProteosError, isUnauthorized, parseErrorResponse, toQueryParams, toQueryString };
+export { AccountClient, type Action, type ActionBinding, ActionSchema, type ActionScope, ActionScopeSchema, type ActionService, type Agent, type AgentActionParams, type AgentArtifactsPayload, AgentClient, type AgentKickoff, type AgentListener, type AgentListenerService, type AgentListenerTriggerType, type AgentMessagePayload, type AgentResourceListOptions, type AgentService, type ApiErrorResponse, type AppendEventRequest, type AssignPermissionRequest, type AssignRoleRequest, type AttachContactAddressRequest, type Attachment, Attribute, AuditFields, type AuthListOptions, type BatchTransactionError, BatchTransactionErrorSchema, type BatchTransactionStatus, type BatchUpsertRecordsResponse, BatchUpsertRecordsResponseSchema, type BatchUpsertTransaction, type BatchUpsertTransactionResult, BatchUpsertTransactionResultSchema, BatchUpsertTransactionSchema, type BinaryRef, type BlockContactRequest, type Channel, type ClientEventType, type ClientToolSchema, type Connection, type ConnectionCredentials, type ConnectionEndpoint, type ConnectionScope, type ConnectionService, type ConnectionStatus, type Connector, ConnectorClient, type ConnectorConnection, type ConnectionScope$1 as ConnectorConnectionScope, type ConnectionStatus$1 as ConnectorConnectionStatus, type ConnectionTokenResponse as ConnectorConnectionTokenResponse, type CredentialKind as ConnectorCredentialKind, type ConnectorKey, type ConnectorMethod, type ConnectorProvider, type ConsentStatus, type ConsumerGroup, type Contact, type ContactAddress, type ContactAddressKind, type ContactAddressSource, type ContactErasureRequest, type ContactMergeProposal, type ContactRef, type ContactService, type ContactSource, type ContactStatus, type ContentBlock$1 as ContentBlock, type ContentMatch, type ContentResponse, type ContextCompactedPayload, type Conversation, ConversationClient, type ConversationParticipant, type ConversationService, type ConversationStatus, type CreateAgentListenerRequest, type CreateAgentRequest, type CreateConnectionRequest, type CreateConnectorConnectionRequest, type CreateFileMetadata, type CreateGlossaryTermRequest, type CreateLabelRequest, type CreateLinkRequest, type CreateMcpServerRequest, type CreateNodeRequest, type CreateOrganizationRequest, type CreatePromptRequest, type CreateRecordLinkRequest, type CreateRoleRequest, type CreateSessionRequest, type CreateToolRequest, type CreateUserRequest, type CreateWorkflowRequest, type CredentialSpec, type CronTriggerParams, DEFAULT_PORT, DataClient, type DispatchMeetingBotRequest, type DisplayOptions, ERROR_PORT, type EditContentRequest, type EditContentResponse, type EmptyPayload, type ErasureRequestStatus, ErrorCode, type ErrorCodeType, type ErrorPayload, type EventTriggerParams, type EventType, type EventVerb, EventsClient, type ExecutionError, type ExecutionStatus, type ExecutionTriggerContext, type FileBlock, FileRef, type FileService, type FileVersionContent, FunctionsClient, type GetExecutionDetailResponse, type GetGraphOptions, type GetNodeExecutionItemsOptions, type GetNodeExecutionItemsResponse, type GetNodeTypesResponse, type GlossaryTerm, type GlossaryTermService, type GraphService, type InlineLinkRequest, type InstallConnectionResponse, type InstallConnectorConnectionResponse, type InvokeActionResponse, type InvokeNodeMethodRequest, type InvokeNodeMethodResponse, type Item, type KickoffSource, type KickoffType, KnowledgeClient, type KnowledgeGraph, type KnowledgeGraphLink, type KnowledgeGraphNode, type KnowledgeLabel, KnowledgeLabelSchema, type KnowledgeLink, KnowledgeLinkSchema, type KnowledgeNode, type KnowledgeNodeLabel, KnowledgeNodeLabelSchema, type KnowledgeNodeMetadata, KnowledgeNodeMetadataSchema, KnowledgeNodeSchema, type KnowledgeNodeSearchResult, KnowledgeNodeSearchResultSchema, type KnowledgeRecordLink, KnowledgeRecordLinkSchema, type LabelService, type LinkService, type LinkType, type ListActionsOptions, type ListAgentListenersQuery, type ListAgentsOptions, type ListConnectionsQuery, type ListConnectorConnectionsQuery, type ListConnectorsQuery, type ListContactAddressesQuery, type ListContactMergeProposalsQuery, type ListContactsQuery, type ListConversationsQuery, type ListEventsOptions, type ListExecutionsOptions, type ListGlossaryTermsQuery, type ListLabelsOptions, type ListLinksOptions, type ListMcpServersOptions, type ListMessagesQuery, type ListNodesOptions, ListOptions, type ListOrganizationsOptions, type ListPromptsOptions, type ListRecordLinksOptions, type ListRecordsOptions, type ListResponse, ListResult, type ListRolePermissionsOptions, type ListRolesOptions, type ListRoomsQuery, type ListSessionsOptions, type ListSkillsOptions, type ListToolsOptions, type ListUserRoleAssignmentsOptions, type ListUsersOptions, type ListWorkflowsOptions, type ManualTriggerParams, type MatchMode, type McpBinding, type McpConnectionState, type McpConnectionStatus, type McpServer, type McpServerAuth, type McpServerOAuth, type McpServerService, type McpToolSummary, type MeService, type MeetingService, type MergeContactsRequest, type MergeProposalStatus, type Message, type ContentBlock as MessageContentBlock, type MessageDirection, type MessageKickoff, type MessagePreview, type MessageRecipient, type MessageService, type MessageStatus, type MessageTriggerParams, type ModelConfig, type ModelRequestEndPayload, type ModelRequestStartPayload, type ModelUsage, type NeighborDirection, type NeighborEdge, type NeighborNode, type NeighborsOptions, type NodeContentMatches, type NodeDescriptor, type NodeExecution, type NodeGroup, type NodeMethodOption, type NodeNeighborhood, NodeNeighborhoodSchema, type NodeOutline, type NodePosition, type NodeProperty, type NodeRetryPolicy, type NodeRuntime, type NodeService, type NodeStatus, type NodeType, type NodeTypeKey, type NodeTypeService, type NodeTypeStatus, type OnErrorPolicy, type Organization, OrganizationSchema, type OrganizationService, type OutcomeKickoff, type OutcomeRubric, type OutlineHeading, type OutlineRequest, type OutlineResponse, PLATFORM_ENTITIES, PLATFORM_ENTITY_SLUGS, PageIterator, type PairedItem, type ParseStatus, type Permission, type PermissionEventSource, type PermissionEventType, type PlatformEntity, type PlatformEvent, type PortSpec, type Prompt, type PromptService, type PromptVersion, type PropertyOption, type PropertyType, ProteosClient, ProteosError, PublicAccessOperation, type PublishEventRequest, type QueryExecuteMeta, type QueryExecuteResponse, type QueryObject, type QueryRow, type QueryService, type QueryValidateMeta, type QueryValidateResponse, type QueryValue, type Reaction, type ReactionCapability, type ReactionOption, type ReactionSetKind, type ReasoningPayload, type RecipientKind, type RecipientRole, type RecordData, type RecordLinkService, type RecordPermissionEventRequest, type RecordService, type RedriveResult, type ResultBlock, type Role, type RoleEntityPermission, RoleEntityPermissionSchema, RoleSchema, type RoleService, type Room, type RunWorkflowRequest, type SearchContentRequest, type SearchContentResponse, type SearchNodesRequest, type SendMessageRequest, type SendRecipient, type Session, type SessionEvent, type SessionEventEnvelope, type SessionEventsOptions, type SessionIdlePayload, type SessionService, type SessionStatus, type SessionStreamOptions, type SessionUpdatedPayload, type Skill, type SkillBundle, type SkillService, type SkillVersion, type StartMcpOAuthResponse, type StopReason, StorageClient, type StorageFile, type StorageFileVersion, type TailOptions, type TestNodeCandidate, type TestNodeInputSource, type TestNodeRequest, type TestNodeResponse, type TextBlock, type Tool, type ToolBinding, type ToolConfirmationPayload, type ToolKind, type ToolResultPayload, type ToolService, type ToolUsePayload, type Topic, type TopicKind, type TopicService, type TranscribeStreamOptions, type TranscriptResult, type TriggerKind, type Turn, type UnreadCounts, type UpdateAgentListenerRequest, type UpdateAgentRequest, type UpdateConnectionRequest, type UpdateConnectorConnectionRequest, type UpdateContactRequest, type UpdateFileMetadata, type UpdateGlossaryTermRequest, type UpdateLabelRequest, type UpdateLinkRequest, type UpdateMcpServerRequest, type UpdateNodeRequest, type UpdateOrganizationRequest, type UpdatePromptRequest, type UpdateRoleRequest, type UpdateToolRequest, type UpdateUserRequest, type UpdateWorkflowRequest, type User, type UserMessagePayload, UserRef$2 as UserRef, type UserRoleAssignment, UserRoleAssignmentSchema, UserSchema, type UserService, type VoiceService, type VoiceTranscriptionStream, type WebhookTriggerParams, type Workflow, WorkflowClient, type WorkflowConnection, type WorkflowContentBlock, type WorkflowExecution, type WorkflowGraph, type WorkflowNode, type WorkflowNodeType, type WorkflowStatus, type WorkflowVersion, type WorkflowVersionAuthor, type WorkflowVersionSummary, type WriteContentResponse, type WriteCredentialsRequest, buildUrl, getDefaultErrorCode, isBadRequest, isConflict, isForbidden, isNotFound, isPlatformEntity, isProteosError, isUnauthorized, parseErrorResponse, toQueryParams, toQueryString };

package/dist/index.js

@@ -1,5 +1,5 @@
-import { AuditFieldsSchema, AttributeSchema, UserRefSchema, PageIterator } from './chunk-YMRMKSZL.js';
-export { AppSchema, AttributeSchema, AuditFieldsSchema, ColumnSchema, ComponentSchema, CurrencyAttributeMetaSchema, DEFAULT_PAGE_SIZE, DONE, DesignReferenceSchema, EntitySchema, EntityWithSchemaSchema, FileRefSchema, FilterElementSchema, FilterGroupSchema, ListSchema, ListViewSchema, MenuConfigurationSchema, MenuItemSchema, MenuItemType, MetaClient, ModuleSchema, OnDeleteActionSchema, PLATFORM_ATTRIBUTE_NAMES, PLATFORM_USER_ID, PageActionSchema, PageIterator, PageLayoutSchema, PageSchema, RelationAttributeMetaSchema, ResponseMetaSchema, SortConfigSchema, UserRefSchema, VariableSchema, allCurrencyCodes, createIterator, createListResultSchema, currencyLabel, currencySymbol, currencySymbolSide, formatAmount, formatMoney, isPlatformAttributeName, localeNumberSeparators, parseAmount, parseCurrencyMeta, parseFileMeta, parseRelationMeta, platformAttributes } from './chunk-YMRMKSZL.js';
+import { AuditFieldsSchema, AttributeSchema, UserRefSchema, PageIterator } from './chunk-Y5RY27JB.js';
+export { AppSchema, AttributeSchema, AuditFieldsSchema, ColumnSchema, ComponentSchema, CurrencyAttributeMetaSchema, DEFAULT_PAGE_SIZE, DONE, DesignReferenceSchema, EntitySchema, EntityWithSchemaSchema, FileRefSchema, FilterElementSchema, FilterGroupSchema, ListSchema, ListViewSchema, MenuConfigurationSchema, MenuItemSchema, MenuItemType, MetaClient, ModuleSchema, OnDeleteActionSchema, PLATFORM_ATTRIBUTE_NAMES, PLATFORM_USER_ID, PageActionSchema, PageIterator, PageLayoutSchema, PageSchema, RelationAttributeMetaSchema, ResponseMetaSchema, SortConfigSchema, UserRefSchema, VariableSchema, allCurrencyCodes, createIterator, createListResultSchema, currencyLabel, currencySymbol, currencySymbolSide, formatAmount, formatMoney, isPlatformAttributeName, localeNumberSeparators, parseAmount, parseCurrencyMeta, parseFileMeta, parseRelationMeta, platformAttributes } from './chunk-Y5RY27JB.js';
 import { z } from 'zod';
 import { fetchEventSource } from '@microsoft/fetch-event-source';
 
@@ -1205,6 +1205,8 @@ var CONVERSATION_BASE_PATH = "/conversations/v1";
 var ConversationClient = class {
   connections;
   conversations;
+  /** The person-level identity layer: contacts, addresses, merges, permissions. */
+  contacts;
   messages;
   agentListeners;
   /** Per-org glossary: custom vocabulary that boosts transcription accuracy. */
@@ -1217,6 +1219,7 @@ var ConversationClient = class {
   constructor(client) {
     this.connections = new ConnectionServiceImpl(client);
     this.conversations = new ConversationServiceImpl(client);
+    this.contacts = new ContactServiceImpl(client);
     this.messages = new MessageServiceImpl(client);
     this.agentListeners = new AgentListenerServiceImpl(client);
     this.glossaryTerms = new GlossaryTermServiceImpl(client);
@@ -1263,10 +1266,10 @@ var ConnectionServiceImpl = class {
   install(id) {
     return this.client.request("POST", `${CONVERSATION_BASE_PATH}/connections/${encodeURIComponent(id)}/install`);
   }
-  listParticipants(connectionId, query = {}) {
+  listContactAddresses(connectionId, query = {}) {
     return this.client.requestWithQuery(
       "GET",
-      `${CONVERSATION_BASE_PATH}/connections/${encodeURIComponent(connectionId)}/participants`,
+      `${CONVERSATION_BASE_PATH}/connections/${encodeURIComponent(connectionId)}/contact-addresses`,
       query
     );
   }
@@ -1278,6 +1281,89 @@ var ConnectionServiceImpl = class {
     );
   }
 };
+var ContactServiceImpl = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  list(query = {}) {
+    return this.client.requestWithQuery("GET", `${CONVERSATION_BASE_PATH}/contacts`, query);
+  }
+  get(id) {
+    return this.client.request("GET", `${CONVERSATION_BASE_PATH}/contacts/${encodeURIComponent(id)}`);
+  }
+  update(id, request) {
+    return this.client.request("PATCH", `${CONVERSATION_BASE_PATH}/contacts/${encodeURIComponent(id)}`, request);
+  }
+  attachAddress(contactId, request) {
+    return this.client.request(
+      "POST",
+      `${CONVERSATION_BASE_PATH}/contacts/${encodeURIComponent(contactId)}/addresses`,
+      request
+    );
+  }
+  detachAddress(contactId, addressId) {
+    return this.client.request(
+      "DELETE",
+      `${CONVERSATION_BASE_PATH}/contacts/${encodeURIComponent(contactId)}/addresses/${encodeURIComponent(addressId)}`
+    );
+  }
+  merge(contactId, request) {
+    return this.client.request(
+      "POST",
+      `${CONVERSATION_BASE_PATH}/contacts/${encodeURIComponent(contactId)}/merge`,
+      request
+    );
+  }
+  recordPermissionEvent(contactId, request) {
+    return this.client.request(
+      "POST",
+      `${CONVERSATION_BASE_PATH}/contacts/${encodeURIComponent(contactId)}/permission-events`,
+      request
+    );
+  }
+  block(contactId, request = {}) {
+    return this.client.request(
+      "POST",
+      `${CONVERSATION_BASE_PATH}/contacts/${encodeURIComponent(contactId)}/block`,
+      request
+    );
+  }
+  unblock(contactId, request = {}) {
+    return this.client.request(
+      "POST",
+      `${CONVERSATION_BASE_PATH}/contacts/${encodeURIComponent(contactId)}/unblock`,
+      request
+    );
+  }
+  requestErasure(contactId) {
+    return this.client.request(
+      "POST",
+      `${CONVERSATION_BASE_PATH}/contacts/${encodeURIComponent(contactId)}/erasure-requests`
+    );
+  }
+  listErasureRequests(contactId) {
+    return this.client.request(
+      "GET",
+      `${CONVERSATION_BASE_PATH}/contacts/${encodeURIComponent(contactId)}/erasure-requests`
+    );
+  }
+  listMergeProposals(query = {}) {
+    return this.client.requestWithQuery("GET", `${CONVERSATION_BASE_PATH}/contact-merge-proposals`, query);
+  }
+  approveMergeProposal(proposalId) {
+    return this.client.request(
+      "POST",
+      `${CONVERSATION_BASE_PATH}/contact-merge-proposals/${encodeURIComponent(proposalId)}/approve`
+    );
+  }
+  rejectMergeProposal(proposalId) {
+    return this.client.request(
+      "POST",
+      `${CONVERSATION_BASE_PATH}/contact-merge-proposals/${encodeURIComponent(proposalId)}/reject`
+    );
+  }
+};
 var ConversationServiceImpl = class {
   constructor(client) {
     this.client = client;
@@ -2024,12 +2110,13 @@ var FileServiceImpl = class {
     );
     return response.data;
   }
-  async update(id, metadata) {
+  async update(id, metadata, file) {
     const formData = new FormData();
     formData.append(
       "metadata",
       new Blob([JSON.stringify(metadata)], { type: "application/json" })
     );
+    if (file) formData.append("file", file, metadata.name ?? file.name);
     const response = await this.client.requestMultipart(
       "PATCH",
       `${FILES_BASE_PATH}/${id}`,