@proteos/sdk 0.44.0 → 0.45.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proteos/sdk",
-  "version": "0.44.0",
+  "version": "0.45.0",
   "license": "Apache-2.0",
   "description": "TypeScript SDK for the Proteos platform",
   "repository": {
@@ -66,8 +66,8 @@
     "tsup": "^8.3.0",
     "typescript": "^5.7.0",
     "vitest": "^3.0.0",
-    "@proteos/tsconfig": "0.0.0",
-    "@proteos/biome-config": "0.0.0"
+    "@proteos/biome-config": "0.0.0",
+    "@proteos/tsconfig": "0.0.0"
   },
   "scripts": {
     "build": "tsup",

package/src/conversation/index.ts

@@ -17,6 +17,10 @@ import type {
   CreateAgentListenerRequest,
   CreateConnectionRequest,
   CreateContactGroupRequest,
+  CreateContactRequest,
+  ContactRecordLink,
+  CreateContactRecordLinkRequest,
+  ListContactRecordLinksQuery,
   CreateConversationFilterRequest,
   CreateConversationTypeRequest,
   CreateGlossaryTermRequest,
@@ -282,9 +286,17 @@ class ConnectionServiceImpl implements ConnectionService {
 export interface ContactService {
   list(query?: ListContactsQuery): Promise<ListResponse<Contact>>
   get(id: string): Promise<Contact>
+  /** Manually mint a contact (sync dedup — 409 contact_address_taken on any owned address). */
+  create(request: CreateContactRequest): Promise<Contact>
   update(id: string, request: UpdateContactRequest): Promise<Contact>
   attachAddress(contactId: string, request: AttachContactAddressRequest): Promise<Contact>
   detachAddress(contactId: string, addressId: string): Promise<Contact>
+  /** Link the contact to a business record (bare edge; 409 contact_record_link_exists on duplicates). */
+  linkRecord(request: CreateContactRecordLinkRequest): Promise<ContactRecordLink>
+  /** Page contact→record edges by contact_id, or by entity_slug + record_id. */
+  listRecordLinks(query?: ListContactRecordLinksQuery): Promise<ListResponse<ContactRecordLink>>
+  getRecordLink(linkId: string): Promise<ContactRecordLink>
+  unlinkRecord(linkId: string): Promise<void>
   /** Fold source_contact_id into contactId (contactId wins). */
   merge(contactId: string, request: MergeContactsRequest): Promise<Contact>
   recordPermissionEvent(contactId: string, request: RecordPermissionEventRequest): Promise<Contact>
@@ -313,6 +325,10 @@ class ContactServiceImpl implements ContactService {
     )
   }
 
+  create(request: CreateContactRequest): Promise<Contact> {
+    return this.client.request('POST', `${CONVERSATION_BASE_PATH}/contacts`, request)
+  }
+
   update(id: string, request: UpdateContactRequest): Promise<Contact> {
     return this.client.request(
       'PATCH',
@@ -336,6 +352,32 @@ class ContactServiceImpl implements ContactService {
     )
   }
 
+  linkRecord(request: CreateContactRecordLinkRequest): Promise<ContactRecordLink> {
+    return this.client.request('POST', `${CONVERSATION_BASE_PATH}/contact-record-links`, request)
+  }
+
+  listRecordLinks(query: ListContactRecordLinksQuery = {}): Promise<ListResponse<ContactRecordLink>> {
+    return this.client.requestWithQuery(
+      'GET',
+      `${CONVERSATION_BASE_PATH}/contact-record-links`,
+      query,
+    )
+  }
+
+  getRecordLink(linkId: string): Promise<ContactRecordLink> {
+    return this.client.request(
+      'GET',
+      `${CONVERSATION_BASE_PATH}/contact-record-links/${encodeURIComponent(linkId)}`,
+    )
+  }
+
+  unlinkRecord(linkId: string): Promise<void> {
+    return this.client.request(
+      'DELETE',
+      `${CONVERSATION_BASE_PATH}/contact-record-links/${encodeURIComponent(linkId)}`,
+    )
+  }
+
   merge(contactId: string, request: MergeContactsRequest): Promise<Contact> {
     return this.client.request(
       'POST',

package/src/conversation/types.ts

@@ -1252,6 +1252,16 @@ export interface UpdateContactRequest {
   group_key?: string
 }
 
+/**
+ * Manually mints a contact with at least one address. Addresses are
+ * canonicalized server-side; any address already owned by another contact
+ * rejects the create with 409 contact_address_taken.
+ */
+export interface CreateContactRequest {
+  name: string
+  addresses: AttachContactAddressRequest[]
+}
+
 export interface AttachContactAddressRequest {
   kind: ContactAddressKind
   scope?: string
@@ -1259,6 +1269,33 @@ export interface AttachContactAddressRequest {
   name?: string
 }
 
+/**
+ * A directed edge from a contact to a business record (entity_slug +
+ * record_id). Bare — no role; the relationship's semantics come from the
+ * target entity. Immutable once created.
+ */
+export interface ContactRecordLink {
+  id: string
+  org_id: string
+  contact_id: string
+  entity_slug: string
+  record_id: string
+  created_at: string
+  created_by: UserRef
+}
+
+export interface CreateContactRecordLinkRequest {
+  contact_id: string
+  entity_slug: string
+  record_id: string
+}
+
+export interface ListContactRecordLinksQuery extends PaginationQuery {
+  contact_id?: string
+  entity_slug?: string
+  record_id?: string
+}
+
 export interface MergeContactsRequest {
   source_contact_id: string
 }