@agentuity/core 1.0.29 → 1.0.31

package/dist/index.d.ts

@@ -8,11 +8,11 @@ export { type DataResult, type DataResultFound, type DataResultNotFound, type Ke
 export { type SessionEventProvider, SessionStartEventSchema, SessionCompleteEventSchema, SessionStartEventDelayedSchema, SessionCompleteEventDelayedSchema, type SessionStartEvent, type SessionCompleteEvent, } from './services/session.ts';
 export { type CreateStreamProps, type ListStreamsParams, type StreamInfo, type ListStreamsResponse, type Stream, type StreamStorage, type StreamSortField, STREAM_MIN_TTL_SECONDS, STREAM_MAX_TTL_SECONDS, STREAM_DEFAULT_TTL_SECONDS, StreamStorageService, } from './services/stream.ts';
 export { type VectorUpsertBase, type VectorUpsertEmbeddings, type VectorUpsertText, type VectorUpsertParams, type VectorSearchParams, type VectorSearchResult, type VectorSearchResultWithDocument, type VectorUpsertResult, type VectorResultFound, type VectorResultNotFound, type VectorResult, type VectorNamespaceStats, type VectorItemStats, type VectorNamespaceStatsWithSamples, type VectorGetAllStatsParams, type VectorStatsPaginated, type VectorStorage, type VectorSortField, VECTOR_MIN_TTL_SECONDS, VECTOR_MAX_TTL_SECONDS, VECTOR_DEFAULT_TTL_SECONDS, VectorStorageService, } from './services/vector.ts';
-export { type QueueService, type QueuePublishParams, type QueuePublishResult, QueueStorageService, QueuePublishError, QueueNotFoundError, QueueValidationError, } from './services/queue.ts';
+export { type QueueService, type QueuePublishParams, type QueuePublishResult, type QueueCreateParams, type QueueCreateResult, QueueStorageService, QueuePublishError, QueueNotFoundError, QueueValidationError, } from './services/queue.ts';
 export { type EmailAddress, type EmailDestination, type EmailProtocolConfig, type EmailConnectionConfig, type EmailInbound, type EmailOutbound, type EmailAttachment, type EmailStoredAttachment, type EmailSendParams, type EmailActivityParams, type EmailActivityDataPoint, type EmailActivityResult, type EmailService, EmailStorageService, } from './services/email.ts';
 export { type Schedule, type ScheduleDestination, type ScheduleDelivery, type CreateScheduleParams, type CreateScheduleDestinationParams, type UpdateScheduleParams, type ScheduleListResult, type ScheduleGetResult, type ScheduleCreateResult, type ScheduleDeliveryListResult, ScheduleService, } from './services/schedule.ts';
 export { type Webhook, type WebhookDestination, type WebhookReceipt, type WebhookDelivery, type CreateWebhookParams, type UpdateWebhookParams, type CreateWebhookDestinationParams, type WebhookListResult, type WebhookGetResult, type WebhookCreateResult, type WebhookReceiptListResult, type WebhookDeliveryListResult, WebhookService, } from './services/webhook.ts';
-export { type TaskPriority, type TaskType, type TaskStatus, type Task, type Comment, type Tag, type TaskChangelogEntry, type CreateTaskParams, type UpdateTaskParams, type ListTasksParams, type ListTasksResult, type TaskChangelogResult, type ListCommentsResult, type ListTagsResult, type ListUsersResult, type ListProjectsResult, type TaskActivityParams, type TaskActivityDataPoint, type TaskActivityResult, type TaskStorage, type Attachment, type CreateAttachmentParams, type PresignUploadResponse, type PresignDownloadResponse, type ListAttachmentsResult, TaskStorageService, } from './services/task.ts';
+export { type TaskPriority, type TaskType, type TaskStatus, type UserType, type EntityRef, type UserEntityRef, type Task, type Comment, type Tag, type TaskChangelogEntry, type CreateTaskParams, type UpdateTaskParams, type ListTasksParams, type ListTasksResult, type BatchDeleteTasksParams, type BatchDeletedTask, type BatchDeleteTasksResult, type TaskChangelogResult, type ListCommentsResult, type ListTagsResult, type ListUsersResult, type ListProjectsResult, type TaskActivityParams, type TaskActivityDataPoint, type TaskActivityResult, type TaskStorage, type Attachment, type CreateAttachmentParams, type PresignUploadResponse, type PresignDownloadResponse, type ListAttachmentsResult, TaskStorageService, } from './services/task.ts';
 export { type EvalRunEventProvider, EvalRunStartEventSchema, EvalRunCompleteEventSchema, EvalRunStartEventDelayedSchema, EvalRunCompleteEventDelayedSchema, type EvalRunStartEvent, type EvalRunCompleteEvent, } from './services/evalrun.ts';
 export { type SandboxResources, type SandboxStatus, type SandboxSortField, type SandboxRuntimeRequirements, type SandboxRuntime, type RuntimeSortField, type ExecutionStatus, type StreamReader, type SandboxStreamConfig, type SandboxCommand, type SandboxNetworkConfig, type SandboxTimeoutConfig, type SandboxCreateOptions, type Sandbox, type SandboxInfo, type SandboxRuntimeInfo, type SandboxSnapshotInfo, type SandboxSnapshotInfoPublic, type SandboxSnapshotInfoPrivate, type SandboxSnapshotUserInfo, type SandboxSnapshotOrgInfo, type SnapshotSortField, type SandboxUserInfo, type SandboxAgentInfo, type SandboxProjectInfo, type SandboxOrgInfo, type ListSandboxesParams, type ListSandboxesResponse, type ListRuntimesParams, type ListRuntimesResponse, type ExecuteOptions, type Execution, type SandboxRunOptions, type SandboxRunResult, type SandboxService, type FileToWrite, type SnapshotFileInfo, type SnapshotOrgInfo, type SnapshotUserInfo, type SnapshotInfo, type SnapshotCreateOptions, type SnapshotListParams, type SnapshotListResponse, type SnapshotService, SandboxError, } from './services/sandbox.ts';
 export { buildUrl, toServiceException, toPayload, fromResponse } from './services/_util.ts';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAG3E,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAG1C,YAAY,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAGpD,YAAY,EACX,YAAY,EACZ,YAAY,EACZ,aAAa,EACb,oBAAoB,EACpB,kBAAkB,EAClB,IAAI,EACJ,UAAU,GACV,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EACX,aAAa,EACb,gBAAgB,EAChB,UAAU,EACV,UAAU,EACV,aAAa,GACb,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EACN,KAAK,UAAU,EACf,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,wBAAwB,EAC7B,KAAK,aAAa,EAClB,KAAK,wBAAwB,EAC7B,KAAK,qBAAqB,EAC1B,KAAK,iBAAiB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,WAAW,EAChB,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,GACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACN,KAAK,oBAAoB,EACzB,uBAAuB,EACvB,0BAA0B,EAC1B,8BAA8B,EAC9B,iCAAiC,EACjC,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,GACzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACN,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,UAAU,EACf,KAAK,mBAAmB,EACxB,KAAK,MAAM,EACX,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,0BAA0B,EAC1B,oBAAoB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACN,KAAK,gBAAgB,EACrB,KAAK,sBAAsB,EAC3B,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,8BAA8B,EACnC,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,YAAY,EACjB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,KAAK,+BAA+B,EACpC,KAAK,uBAAuB,EAC5B,KAAK,oBAAoB,EACzB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,sBAAsB,EACtB,sBAAsB,EACtB,0BAA0B,EAC1B,oBAAoB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACN,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACN,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,YAAY,EACjB,KAAK,aAAa,EAClB,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC1B,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,sBAAsB,EAC3B,KAAK,mBAAmB,EACxB,KAAK,YAAY,EACjB,mBAAmB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACN,KAAK,QAAQ,EACb,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,+BAA+B,EACpC,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,EACzB,KAAK,0BAA0B,EAC/B,eAAe,GACf,MAAM,wBAAwB,CAAC;AAChC,OAAO,EACN,KAAK,OAAO,EACZ,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,8BAA8B,EACnC,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,mBAAmB,EACxB,KAAK,wBAAwB,EAC7B,KAAK,yBAAyB,EAC9B,cAAc,GACd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACN,KAAK,YAAY,EACjB,KAAK,QAAQ,EACb,KAAK,UAAU,EACf,KAAK,IAAI,EACT,KAAK,OAAO,EACZ,KAAK,GAAG,EACR,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,eAAe,EACpB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,eAAe,EACpB,KAAK,kBAAkB,EACvB,KAAK,kBAAkB,EACvB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,WAAW,EAChB,KAAK,UAAU,EACf,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,qBAAqB,EAC1B,kBAAkB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EACN,KAAK,oBAAoB,EACzB,uBAAuB,EACvB,0BAA0B,EAC1B,8BAA8B,EAC9B,iCAAiC,EACjC,KAAK,iBAAiB,EACtB,KAAK,oBAAoB,GACzB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACN,KAAK,gBAAgB,EACrB,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,0BAA0B,EAC/B,KAAK,cAAc,EACnB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,YAAY,EACjB,KAAK,mBAAmB,EACxB,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,oBAAoB,EACzB,KAAK,OAAO,EACZ,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,yBAAyB,EAC9B,KAAK,0BAA0B,EAC/B,KAAK,uBAAuB,EAC5B,KAAK,sBAAsB,EAC3B,KAAK,iBAAiB,EACtB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,EACvB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,cAAc,EACnB,KAAK,SAAS,EACd,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EACrB,KAAK,cAAc,EACnB,KAAK,WAAW,EAEhB,KAAK,gBAAgB,EACrB,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,EACzB,KAAK,eAAe,EACpB,YAAY,GACZ,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAG5F,YAAY,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAG7D,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGxD,YAAY,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAG/D,OAAO,EACN,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,EAClB,KAAK,eAAe,GACpB,MAAM,uBAAuB,CAAC;AAG/B,YAAY,EACX,cAAc,EACd,YAAY,EACZ,aAAa,EACb,SAAS,EACT,qBAAqB,EACrB,sBAAsB,EACtB,iBAAiB,EACjB,kBAAkB,EAClB,gBAAgB,EAChB,wBAAwB,EACxB,wBAAwB,EACxB,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,WAAW,GACX,MAAM,aAAa,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mBAAmB;AACnB,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE3E,kBAAkB;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAsB1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAYN,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,GACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAEN,uBAAuB,EACvB,0BAA0B,EAC1B,8BAA8B,EAC9B,iCAAiC,GAGjC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAQN,sBAAsB,EACtB,sBAAsB,EACtB,0BAA0B,EAC1B,oBAAoB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAmBN,sBAAsB,EACtB,sBAAsB,EACtB,0BAA0B,EAC1B,oBAAoB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAIN,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAcN,mBAAmB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAWN,eAAe,GACf,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAaN,cAAc,GACd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EA0BN,kBAAkB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEN,uBAAuB,EACvB,0BAA0B,EAC1B,8BAA8B,EAC9B,iCAAiC,GAGjC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EA8CN,YAAY,GACZ,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAK5F,oBAAoB;AACpB,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKxD,oBAAoB;AACpB,OAAO,EACN,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,GAElB,MAAM,uBAAuB,CAAC;AAqB/B,4EAA4E"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mBAAmB;AACnB,OAAO,EAAE,SAAS,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAE3E,kBAAkB;AAClB,OAAO,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAsB1C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAYN,kBAAkB,EAClB,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,GACtB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAEN,uBAAuB,EACvB,0BAA0B,EAC1B,8BAA8B,EAC9B,iCAAiC,GAGjC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAQN,sBAAsB,EACtB,sBAAsB,EACtB,0BAA0B,EAC1B,oBAAoB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAmBN,sBAAsB,EACtB,sBAAsB,EACtB,0BAA0B,EAC1B,oBAAoB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAMN,mBAAmB,EACnB,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,GACpB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAcN,mBAAmB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAWN,eAAe,GACf,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAaN,cAAc,GACd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAgCN,kBAAkB,GAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEN,uBAAuB,EACvB,0BAA0B,EAC1B,8BAA8B,EAC9B,iCAAiC,GAGjC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EA8CN,YAAY,GACZ,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,QAAQ,EAAE,kBAAkB,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAK5F,oBAAoB;AACpB,OAAO,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAKxD,oBAAoB;AACpB,OAAO,EACN,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,qBAAqB,EACrB,kBAAkB,GAElB,MAAM,uBAAuB,CAAC;AAqB/B,4EAA4E"}

package/dist/services/email.d.ts

@@ -1,72 +1,238 @@
 import { FetchAdapter } from './adapter.ts';
 /**
- * An email address registered with the Agentuity email service
+ * An email address registered with the Agentuity email service.
+ *
+ * Email addresses are created under the `@agentuity.email` domain and can receive
+ * inbound emails (forwarded to configured destinations) and send outbound emails.
  */
 export interface EmailAddress {
+    /**
+     * Unique identifier for the email address.
+     *
+     * @remarks Prefixed with `eaddr_`.
+     */
     id: string;
+    /**
+     * The full email address (e.g., `support@agentuity.email`).
+     */
     email: string;
+    /**
+     * Provider-specific configuration (e.g., inbound routing config).
+     *
+     * @remarks Opaque to callers — the structure is managed by the platform.
+     */
     config?: Record<string, unknown>;
+    /**
+     * ID of the user who registered this address.
+     */
     created_by?: string;
+    /**
+     * ISO 8601 timestamp when the address was created.
+     */
     created_at: string;
+    /**
+     * ISO 8601 timestamp when the address was last updated.
+     */
     updated_at?: string;
+    /**
+     * Total number of inbound emails received at this address.
+     */
     inbound_count?: number;
+    /**
+     * Total number of outbound emails sent from this address.
+     */
     outbound_count?: number;
+    /**
+     * ISO 8601 timestamp of the most recent inbound or outbound email activity.
+     */
     last_activity?: string;
 }
 /**
- * A destination configuration for an email address
+ * A destination configuration for an email address.
+ *
+ * When an inbound email is received at the parent address, the platform forwards
+ * it to each configured destination via an HTTP request.
  */
 export interface EmailDestination {
+    /**
+     * Unique identifier for the destination.
+     *
+     * @remarks Prefixed with `edst_`.
+     */
     id: string;
+    /**
+     * The destination type. Currently only `'url'` is supported.
+     */
     type: string;
+    /**
+     * Destination-specific configuration.
+     *
+     * @remarks
+     * For `'url'` type the shape is:
+     * ```typescript
+     * {
+     *   url: string;             // Must use http or https; must not point to private/loopback addresses
+     *   headers?: Record<string, string>;
+     *   method?: 'POST' | 'PUT' | 'PATCH';
+     * }
+     * ```
+     */
     config?: Record<string, unknown>;
+    /**
+     * ISO 8601 timestamp when the destination was created.
+     */
     created_at: string;
+    /**
+     * ISO 8601 timestamp when the destination was last updated.
+     */
     updated_at?: string;
 }
+/**
+ * Connection settings for an email protocol (IMAP or POP3).
+ *
+ * Used to configure a mail client for accessing an Agentuity email address
+ * via standard mail protocols.
+ */
 export interface EmailProtocolConfig {
+    /**
+     * The mail server hostname.
+     */
     host: string;
+    /**
+     * The mail server port number.
+     */
     port: number;
+    /**
+     * TLS mode (e.g., `'starttls'`, `'ssl'`, `'none'`).
+     */
     tls: string;
+    /**
+     * The authentication username (typically the address ID).
+     */
     username: string;
+    /**
+     * The authentication password.
+     */
     password: string;
 }
+/**
+ * Full connection configuration for accessing an email address via IMAP and POP3 protocols.
+ *
+ * Returned by {@link EmailService.getConnectionConfig} to allow external mail clients
+ * to connect to an Agentuity email address.
+ */
 export interface EmailConnectionConfig {
+    /**
+     * The full email address these settings are for.
+     */
     email: string;
+    /**
+     * IMAP protocol connection settings.
+     */
     imap: EmailProtocolConfig;
+    /**
+     * POP3 protocol connection settings.
+     */
     pop3: EmailProtocolConfig;
 }
 /**
- * An inbound email message
+ * An inbound email message received at an Agentuity email address.
  */
 export interface EmailInbound {
+    /**
+     * Unique identifier for the inbound email.
+     *
+     * @remarks Prefixed with `einb_`.
+     */
     id: string;
+    /**
+     * The sender's email address.
+     */
     from: string;
+    /**
+     * The recipient email address (comma-separated if multiple).
+     */
     to: string;
+    /**
+     * The email subject line.
+     */
     subject?: string;
+    /**
+     * Plain text body of the email.
+     */
     text?: string;
+    /**
+     * HTML body of the email.
+     */
     html?: string;
+    /**
+     * ISO 8601 timestamp when the email was received.
+     */
     received_at?: string;
+    /**
+     * Raw email headers as key-value pairs.
+     */
     headers?: Record<string, unknown>;
+    /**
+     * Array of stored attachment metadata with S3 locations.
+     */
     attachments?: EmailStoredAttachment[];
 }
 /**
- * An outbound email message
+ * An outbound email message sent from an Agentuity email address.
  */
 export interface EmailOutbound {
+    /**
+     * Unique identifier for the outbound email.
+     *
+     * @remarks Prefixed with `eout_`.
+     */
     id: string;
+    /**
+     * The sender's email address (must be owned by the organization).
+     */
     from: string;
+    /**
+     * The recipient email addresses (comma-separated).
+     */
     to: string;
+    /**
+     * The email subject line.
+     */
     subject?: string;
+    /**
+     * Plain text body of the email.
+     */
     text?: string;
+    /**
+     * HTML body of the email.
+     */
     html?: string;
+    /**
+     * Delivery status: `'pending'`, `'success'`, or `'failed'`.
+     *
+     * @remarks Emails are sent asynchronously, so the initial status is always `'pending'`.
+     */
     status?: string;
+    /**
+     * Error message if the delivery failed.
+     */
     error?: string;
+    /**
+     * ISO 8601 timestamp when the send was initiated.
+     */
     created_at?: string;
+    /**
+     * Custom email headers that were included.
+     */
     headers?: Record<string, unknown>;
+    /**
+     * Array of stored attachment metadata with S3 locations.
+     */
     attachments?: EmailStoredAttachment[];
 }
 /**
- * An email attachment
+ * An email attachment to include when sending an outbound email.
  */
 export interface EmailAttachment {
     /**
@@ -134,24 +300,46 @@ export interface EmailSendParams {
     headers?: Record<string, string>;
 }
 /**
- * Parameters for email activity time-series
+ * Parameters for querying email activity time-series data.
  */
 export interface EmailActivityParams {
+    /**
+     * Number of days of activity to retrieve.
+     *
+     * @remarks Values below 7 are clamped to 7; values above 365 are clamped to 365.
+     *
+     * @default 7
+     */
     days?: number;
 }
 /**
- * A single data point in the email activity time-series
+ * A single data point in the email activity time-series.
  */
 export interface EmailActivityDataPoint {
+    /**
+     * The date in `YYYY-MM-DD` format.
+     */
     date: string;
+    /**
+     * Number of inbound emails received on this date.
+     */
     inbound: number;
+    /**
+     * Number of outbound emails sent on this date.
+     */
     outbound: number;
 }
 /**
- * Result of email activity query
+ * Result of an email activity query containing daily time-series data.
  */
 export interface EmailActivityResult {
+    /**
+     * Array of daily activity data points, ordered chronologically.
+     */
     activity: EmailActivityDataPoint[];
+    /**
+     * The number of days of data returned.
+     */
     days: number;
 }
 /**
@@ -379,24 +567,335 @@ export interface EmailService {
      */
     getActivity(params?: EmailActivityParams): Promise<EmailActivityResult>;
 }
+/**
+ * Client for the Agentuity Email service.
+ *
+ * Provides methods for managing email addresses, configuring inbound email
+ * destinations, sending outbound emails, and querying email history.
+ *
+ * Email addresses are created under the `@agentuity.email` domain. Inbound emails
+ * can be forwarded to URL destinations. Outbound emails are sent asynchronously
+ * and support attachments up to 25 MB total.
+ *
+ * All methods are instrumented with OpenTelemetry spans for observability.
+ *
+ * @example
+ * ```typescript
+ * const email = new EmailStorageService(baseUrl, adapter);
+ *
+ * // Create an address
+ * const addr = await email.createAddress('notifications');
+ *
+ * // Send an email
+ * await email.send({
+ *   from: addr.email,
+ *   to: ['user@example.com'],
+ *   subject: 'Hello',
+ *   text: 'Hello from Agentuity!',
+ * });
+ * ```
+ */
 export declare class EmailStorageService implements EmailService {
     #private;
+    /**
+     * Create a new EmailStorageService instance.
+     *
+     * @param baseUrl - The base URL for the Agentuity Email API (e.g., `https://api.agentuity.com`)
+     * @param adapter - The HTTP fetch adapter used for making API requests
+     */
     constructor(baseUrl: string, adapter: FetchAdapter);
+    /**
+     * Create a new email address under the `@agentuity.email` domain.
+     *
+     * @param localPart - The local part of the email address (the part before the `@`).
+     *   For example, passing `'support'` creates `support@agentuity.email`.
+     * @returns The newly created email address record
+     * @throws ServiceException on API errors (e.g., duplicate address, invalid local part)
+     *
+     * @example
+     * ```typescript
+     * const addr = await email.createAddress('support');
+     * console.log('Created:', addr.email); // support@agentuity.email
+     * ```
+     */
     createAddress(localPart: string): Promise<EmailAddress>;
+    /**
+     * List all email addresses owned by the current organization.
+     *
+     * @returns An array of email address records. Returns an empty array if none exist.
+     * @throws ServiceException on API errors
+     *
+     * @example
+     * ```typescript
+     * const addresses = await email.listAddresses();
+     * for (const addr of addresses) {
+     *   console.log(`${addr.email} — ${addr.inbound_count ?? 0} received`);
+     * }
+     * ```
+     */
     listAddresses(): Promise<EmailAddress[]>;
+    /**
+     * Get an email address by its ID.
+     *
+     * @param id - The email address ID (prefixed with `eaddr_`)
+     * @returns The email address record, or `null` if no address with the given ID exists
+     * @throws ServiceException on API errors (other than 404)
+     *
+     * @example
+     * ```typescript
+     * const addr = await email.getAddress('eaddr_abc123');
+     * if (addr) {
+     *   console.log('Found:', addr.email);
+     * }
+     * ```
+     */
     getAddress(id: string): Promise<EmailAddress | null>;
+    /**
+     * Get IMAP and POP3 connection settings for an email address.
+     *
+     * These settings can be used to configure an external mail client (e.g., Thunderbird, Outlook)
+     * to access the mailbox associated with the given address.
+     *
+     * @param id - The email address ID (prefixed with `eaddr_`)
+     * @returns The connection configuration with IMAP and POP3 settings, or `null` if the address is not found
+     * @throws ServiceException on API errors (other than 404)
+     *
+     * @example
+     * ```typescript
+     * const config = await email.getConnectionConfig('eaddr_abc123');
+     * if (config) {
+     *   console.log('IMAP host:', config.imap.host);
+     *   console.log('POP3 host:', config.pop3.host);
+     * }
+     * ```
+     */
     getConnectionConfig(id: string): Promise<EmailConnectionConfig | null>;
+    /**
+     * Delete an email address and all associated destinations.
+     *
+     * @remarks This operation is idempotent — deleting a non-existent address does not throw.
+     *
+     * @param id - The email address ID (prefixed with `eaddr_`)
+     * @throws ServiceException on API errors (other than 404)
+     *
+     * @example
+     * ```typescript
+     * await email.deleteAddress('eaddr_abc123');
+     * ```
+     */
     deleteAddress(id: string): Promise<void>;
+    /**
+     * Create a new destination for an email address.
+     *
+     * Destinations determine where inbound emails are forwarded when they arrive
+     * at the parent address.
+     *
+     * @param addressId - The email address ID (prefixed with `eaddr_`)
+     * @param type - The destination type (currently only `'url'` is supported)
+     * @param config - Type-specific destination configuration. For `'url'`:
+     *   `{ url: string, headers?: Record<string, string>, method?: 'POST' | 'PUT' | 'PATCH' }`
+     * @returns The newly created destination record
+     * @throws ServiceException on API errors (e.g., invalid URL, address not found)
+     *
+     * @example
+     * ```typescript
+     * const dest = await email.createDestination('eaddr_abc123', 'url', {
+     *   url: 'https://example.com/webhook',
+     *   headers: { 'X-Secret': 'my-token' },
+     * });
+     * console.log('Destination created:', dest.id);
+     * ```
+     */
     createDestination(addressId: string, type: string, config: Record<string, unknown>): Promise<EmailDestination>;
+    /**
+     * List all destinations configured for an email address.
+     *
+     * @param addressId - The email address ID (prefixed with `eaddr_`)
+     * @returns An array of destination records. Returns an empty array if none exist.
+     * @throws ServiceException on API errors
+     *
+     * @example
+     * ```typescript
+     * const destinations = await email.listDestinations('eaddr_abc123');
+     * for (const dest of destinations) {
+     *   console.log(`${dest.type}: ${dest.id}`);
+     * }
+     * ```
+     */
     listDestinations(addressId: string): Promise<EmailDestination[]>;
+    /**
+     * Delete a destination from an email address.
+     *
+     * @remarks This operation is idempotent — deleting a non-existent destination does not throw.
+     *
+     * @param addressId - The email address ID (prefixed with `eaddr_`)
+     * @param destinationId - The destination ID (prefixed with `edst_`)
+     * @throws ServiceException on API errors (other than 404)
+     *
+     * @example
+     * ```typescript
+     * await email.deleteDestination('eaddr_abc123', 'edst_xyz789');
+     * ```
+     */
     deleteDestination(addressId: string, destinationId: string): Promise<void>;
+    /**
+     * Send an outbound email from an Agentuity email address.
+     *
+     * Emails are sent asynchronously — this method returns immediately with an outbound
+     * record whose status is `'pending'`. Use {@link getOutbound} to poll for delivery status.
+     *
+     * @remarks
+     * - The `from` address must be owned by the current organization.
+     * - Maximum 50 recipients per send.
+     * - Maximum 25 MB for the full RFC 822 body (including attachments).
+     *
+     * @param params - The email send parameters including from, to, subject, and body
+     * @returns The outbound email record with initial status `'pending'`
+     * @throws ServiceException on API errors (e.g., invalid sender, too many recipients)
+     *
+     * @example
+     * ```typescript
+     * const result = await email.send({
+     *   from: 'notifications@agentuity.email',
+     *   to: ['user@example.com'],
+     *   subject: 'Welcome!',
+     *   text: 'Welcome to our platform.',
+     *   html: '<h1>Welcome!</h1>',
+     *   attachments: [{
+     *     filename: 'guide.pdf',
+     *     content: base64EncodedPdf,
+     *     contentType: 'application/pdf',
+     *   }],
+     * });
+     * console.log('Email queued:', result.id);
+     * ```
+     */
     send(params: EmailSendParams): Promise<EmailOutbound>;
+    /**
+     * List inbound emails, optionally filtered by email address.
+     *
+     * @param addressId - Optional email address ID (prefixed with `eaddr_`) to filter results.
+     *   When omitted, returns inbound emails across all addresses in the organization.
+     * @returns An array of inbound email records. Returns an empty array if none exist.
+     * @throws ServiceException on API errors
+     *
+     * @example
+     * ```typescript
+     * // List all inbound emails
+     * const all = await email.listInbound();
+     *
+     * // List inbound for a specific address
+     * const filtered = await email.listInbound('eaddr_abc123');
+     * for (const msg of filtered) {
+     *   console.log(`From: ${msg.from}, Subject: ${msg.subject}`);
+     * }
+     * ```
+     */
     listInbound(addressId?: string): Promise<EmailInbound[]>;
+    /**
+     * Get an inbound email by its ID.
+     *
+     * @param id - The inbound email ID (prefixed with `einb_`)
+     * @returns The inbound email record, or `null` if not found
+     * @throws ServiceException on API errors (other than 404)
+     *
+     * @example
+     * ```typescript
+     * const msg = await email.getInbound('einb_abc123');
+     * if (msg) {
+     *   console.log('Subject:', msg.subject);
+     *   console.log('Attachments:', msg.attachments?.length ?? 0);
+     * }
+     * ```
+     */
     getInbound(id: string): Promise<EmailInbound | null>;
+    /**
+     * Delete an inbound email by its ID.
+     *
+     * @remarks This operation is idempotent — deleting a non-existent email does not throw.
+     *
+     * @param id - The inbound email ID (prefixed with `einb_`)
+     * @throws ServiceException on API errors (other than 404)
+     *
+     * @example
+     * ```typescript
+     * await email.deleteInbound('einb_abc123');
+     * ```
+     */
     deleteInbound(id: string): Promise<void>;
+    /**
+     * List outbound emails, optionally filtered by email address.
+     *
+     * @param addressId - Optional email address ID (prefixed with `eaddr_`) to filter results.
+     *   When omitted, returns outbound emails across all addresses in the organization.
+     * @returns An array of outbound email records. Returns an empty array if none exist.
+     * @throws ServiceException on API errors
+     *
+     * @example
+     * ```typescript
+     * // List all outbound emails
+     * const all = await email.listOutbound();
+     *
+     * // List outbound for a specific address
+     * const filtered = await email.listOutbound('eaddr_abc123');
+     * for (const msg of filtered) {
+     *   console.log(`To: ${msg.to}, Status: ${msg.status}`);
+     * }
+     * ```
+     */
     listOutbound(addressId?: string): Promise<EmailOutbound[]>;
+    /**
+     * Get an outbound email by its ID.
+     *
+     * @param id - The outbound email ID (prefixed with `eout_`)
+     * @returns The outbound email record, or `null` if not found
+     * @throws ServiceException on API errors (other than 404)
+     *
+     * @example
+     * ```typescript
+     * const msg = await email.getOutbound('eout_abc123');
+     * if (msg) {
+     *   console.log('Status:', msg.status);
+     *   if (msg.error) {
+     *     console.error('Delivery failed:', msg.error);
+     *   }
+     * }
+     * ```
+     */
     getOutbound(id: string): Promise<EmailOutbound | null>;
+    /**
+     * Delete an outbound email by its ID.
+     *
+     * @remarks This operation is idempotent — deleting a non-existent email does not throw.
+     *
+     * @param id - The outbound email ID (prefixed with `eout_`)
+     * @throws ServiceException on API errors (other than 404)
+     *
+     * @example
+     * ```typescript
+     * await email.deleteOutbound('eout_abc123');
+     * ```
+     */
     deleteOutbound(id: string): Promise<void>;
+    /**
+     * Get email activity time-series data showing inbound and outbound counts per day.
+     *
+     * @param params - Optional query parameters. `days` controls the lookback window
+     *   (minimum 7, maximum 365, server default 7).
+     * @returns An {@link EmailActivityResult} with daily data points ordered chronologically
+     *   and the total number of days returned
+     * @throws ServiceException on API errors
+     *
+     * @example
+     * ```typescript
+     * // Get last 30 days of activity
+     * const result = await email.getActivity({ days: 30 });
+     * console.log(`Activity over ${result.days} days:`);
+     * for (const point of result.activity) {
+     *   console.log(`  ${point.date}: ${point.inbound} in, ${point.outbound} out`);
+     * }
+     * ```
+     */
     getActivity(params?: EmailActivityParams): Promise<EmailActivityResult>;
 }
 //# sourceMappingURL=email.d.ts.map