Skip to main content

MailApi

@codebolt/plugin-sdk


Class: MailApi

Defined in: CodeBolt/packages/pluginSdk/src/api/mail.api.ts:28

Provides API methods for the inter-agent mail system.

The mail system enables structured, asynchronous communication between agents through threads, messages, and inboxes. It also supports resource reservations to coordinate concurrent access to shared resources across agents.

Constructors

Constructor

new MailApi(http: HttpClient): MailApi;

Defined in: CodeBolt/packages/pluginSdk/src/api/mail.api.ts:29

Parameters

ParameterType
httpHttpClient

Returns

MailApi

Methods

acknowledgeMessage()

acknowledgeMessage(messageId: string): Promise<void>;

Defined in: CodeBolt/packages/pluginSdk/src/api/mail.api.ts:69

Parameters

ParameterType
messageIdstring

Returns

Promise<void>


checkReservationConflicts()

checkReservationConflicts(data: CheckReservationConflictsRequest): Promise<{
hasConflict: boolean;
}>;

Defined in: CodeBolt/packages/pluginSdk/src/api/mail.api.ts:125

Parameters

ParameterType
dataCheckReservationConflictsRequest

Returns

Promise<{ hasConflict: boolean; }>


createAgent()

createAgent(data: CreateMailAgentRequest): Promise<MailAgent>;

Defined in: CodeBolt/packages/pluginSdk/src/api/mail.api.ts:95

Parameters

ParameterType
dataCreateMailAgentRequest

Returns

Promise<MailAgent>


createReservation()

createReservation(data: CreateReservationRequest): Promise<MailReservation>;

Defined in: CodeBolt/packages/pluginSdk/src/api/mail.api.ts:109

Parameters

ParameterType
dataCreateReservationRequest

Returns

Promise<MailReservation>


createThread()

createThread(data: CreateMailThreadRequest): Promise<MailThread>;

Defined in: CodeBolt/packages/pluginSdk/src/api/mail.api.ts:37

Parameters

ParameterType
dataCreateMailThreadRequest

Returns

Promise<MailThread>


createThreadMessage()

createThreadMessage(threadId: string, data: SendMailMessageRequest): Promise<MailMessage>;

Defined in: CodeBolt/packages/pluginSdk/src/api/mail.api.ts:59

Parameters

ParameterType
threadIdstring
dataSendMailMessageRequest

Returns

Promise<MailMessage>


deleteThread()

deleteThread(threadId: string): Promise<void>;

Defined in: CodeBolt/packages/pluginSdk/src/api/mail.api.ts:49

Parameters

ParameterType
threadIdstring

Returns

Promise<void>


forceReservation()

forceReservation(data: ForceReservationRequest): Promise<void>;

Defined in: CodeBolt/packages/pluginSdk/src/api/mail.api.ts:117

Parameters

ParameterType
dataForceReservationRequest

Returns

Promise<void>


getAgent()

getAgent(agentId: string): Promise<MailAgent>;

Defined in: CodeBolt/packages/pluginSdk/src/api/mail.api.ts:99

Parameters

ParameterType
agentIdstring

Returns

Promise<MailAgent>


getAgentInbox()

getAgentInbox(agentId: string): Promise<MailMessage[]>;

Defined in: CodeBolt/packages/pluginSdk/src/api/mail.api.ts:103

Parameters

ParameterType
agentIdstring

Returns

Promise<MailMessage[]>


getAgents()

getAgents(): Promise<MailAgent[]>;

Defined in: CodeBolt/packages/pluginSdk/src/api/mail.api.ts:91

Returns

Promise<MailAgent[]>


getReservations()

getReservations(params?: Record<string, unknown>): Promise<MailReservation[]>;

Defined in: CodeBolt/packages/pluginSdk/src/api/mail.api.ts:121

Parameters

ParameterType
params?Record<string, unknown>

Returns

Promise<MailReservation[]>


getThread()

getThread(threadId: string): Promise<MailThread>;

Defined in: CodeBolt/packages/pluginSdk/src/api/mail.api.ts:41

Parameters

ParameterType
threadIdstring

Returns

Promise<MailThread>


getThreadMessages()

getThreadMessages(threadId: string): Promise<MailMessage[]>;

Defined in: CodeBolt/packages/pluginSdk/src/api/mail.api.ts:55

Parameters

ParameterType
threadIdstring

Returns

Promise<MailMessage[]>


getThreads()

getThreads(params?: MailThreadListParams): Promise<MailThread[]>;

Defined in: CodeBolt/packages/pluginSdk/src/api/mail.api.ts:33

Parameters

ParameterType
params?MailThreadListParams

Returns

Promise<MailThread[]>


markMessageRead()

markMessageRead(messageId: string): Promise<void>;

Defined in: CodeBolt/packages/pluginSdk/src/api/mail.api.ts:65

Parameters

ParameterType
messageIdstring

Returns

Promise<void>


releaseReservation()

releaseReservation(data: ReleaseReservationRequest): Promise<void>;

Defined in: CodeBolt/packages/pluginSdk/src/api/mail.api.ts:113

Parameters

ParameterType
dataReleaseReservationRequest

Returns

Promise<void>


replyToMessage()

replyToMessage(data: ReplyToMessageRequest): Promise<MailMessage>;

Defined in: CodeBolt/packages/pluginSdk/src/api/mail.api.ts:73

Parameters

ParameterType
dataReplyToMessageRequest

Returns

Promise<MailMessage>


searchMessages()

searchMessages(params?: MailSearchParams): Promise<MailMessage[]>;

Defined in: CodeBolt/packages/pluginSdk/src/api/mail.api.ts:81

Parameters

ParameterType
params?MailSearchParams

Returns

Promise<MailMessage[]>


send()

send(data: SendMailMessageRequest): Promise<MailMessage>;

Defined in: CodeBolt/packages/pluginSdk/src/api/mail.api.ts:77

Parameters

ParameterType
dataSendMailMessageRequest

Returns

Promise<MailMessage>


summarizeThread()

summarizeThread(threadId: string): Promise<MailThreadSummary>;

Defined in: CodeBolt/packages/pluginSdk/src/api/mail.api.ts:85

Parameters

ParameterType
threadIdstring

Returns

Promise<MailThreadSummary>


updateThread()

updateThread(threadId: string, data: UpdateMailThreadRequest): Promise<MailThread>;

Defined in: CodeBolt/packages/pluginSdk/src/api/mail.api.ts:45

Parameters

ParameterType
threadIdstring
dataUpdateMailThreadRequest

Returns

Promise<MailThread>