aamp-sdk 0.1.12 → 0.1.14

package/dist/types.d.ts

@@ -2,15 +2,17 @@
  * AAMP SDK Type Definitions
  */
 export declare const AAMP_PROTOCOL_VERSION = "1.0";
-export type AampIntent = 'task.dispatch' | 'task.result' | 'task.help_needed' | 'task.ack';
-export type TaskStatus = 'pending' | 'running' | 'completed' | 'rejected' | 'failed' | 'timeout' | 'help_needed';
+export type AampIntent = 'task.dispatch' | 'task.cancel' | 'task.result' | 'task.help_needed' | 'task.ack' | 'card.query' | 'card.response';
+export type TaskPriority = 'urgent' | 'high' | 'normal';
+export type TaskStatus = 'pending' | 'running' | 'completed' | 'rejected' | 'failed' | 'help_needed' | 'cancelled' | 'expired';
 export declare const AAMP_HEADER: {
     readonly VERSION: "X-AAMP-Version";
     readonly INTENT: "X-AAMP-Intent";
     readonly TASK_ID: "X-AAMP-TaskId";
-    readonly TIMEOUT: "X-AAMP-Timeout";
     readonly CONTEXT_LINKS: "X-AAMP-ContextLinks";
     readonly DISPATCH_CONTEXT: "X-AAMP-Dispatch-Context";
+    readonly PRIORITY: "X-AAMP-Priority";
+    readonly EXPIRES_AT: "X-AAMP-Expires-At";
     readonly STATUS: "X-AAMP-Status";
     readonly OUTPUT: "X-AAMP-Output";
     readonly ERROR_MSG: "X-AAMP-ErrorMsg";
@@ -19,6 +21,7 @@ export declare const AAMP_HEADER: {
     readonly BLOCKED_REASON: "X-AAMP-BlockedReason";
     readonly SUGGESTED_OPTIONS: "X-AAMP-SuggestedOptions";
     readonly PARENT_TASK_ID: "X-AAMP-ParentTaskId";
+    readonly CARD_SUMMARY: "X-AAMP-Card-Summary";
 };
 export interface StructuredResultField {
     fieldKey: string;
@@ -33,7 +36,8 @@ export interface TaskDispatch {
     intent: 'task.dispatch';
     taskId: string;
     title: string;
-    timeoutSecs: number;
+    priority: TaskPriority;
+    expiresAt?: string;
     contextLinks: string[];
     dispatchContext?: Record<string, string>;
     parentTaskId?: string;
@@ -46,6 +50,16 @@ export interface TaskDispatch {
     /** Attachments received with this dispatch (use blobId to download) */
     attachments?: ReceivedAttachment[];
 }
+export interface TaskCancel {
+    protocolVersion: string;
+    intent: 'task.cancel';
+    taskId: string;
+    from: string;
+    to: string;
+    messageId?: string;
+    subject: string;
+    bodyText: string;
+}
 export interface TaskResult {
     protocolVersion: string;
     intent: 'task.result';
@@ -93,6 +107,27 @@ export interface TaskAck {
     to: string;
     messageId?: string;
 }
+export interface CardQuery {
+    protocolVersion: string;
+    intent: 'card.query';
+    taskId: string;
+    from: string;
+    to: string;
+    messageId?: string;
+    subject: string;
+    bodyText: string;
+}
+export interface CardResponse {
+    protocolVersion: string;
+    intent: 'card.response';
+    taskId: string;
+    summary: string;
+    from: string;
+    to: string;
+    messageId?: string;
+    subject: string;
+    bodyText: string;
+}
 /** Attachment for sending (binary content) */
 export interface AampAttachment {
     filename: string;
@@ -107,19 +142,15 @@ export interface ReceivedAttachment {
     size: number;
     blobId: string;
 }
-export type AampMessage = TaskDispatch | TaskResult | TaskHelp | TaskAck | HumanReply;
+export type AampMessage = TaskDispatch | TaskCancel | TaskResult | TaskHelp | TaskAck | CardQuery | CardResponse | HumanReply;
 export interface AampClientConfig {
     /** Node email address, e.g. codereviewer-abc123@aamp.yourdomain.com */
     email: string;
     /** Mailbox token for HTTP Basic Auth. Equivalent to base64(email:smtpPassword). */
-    mailboxToken?: string;
-    /** @deprecated legacy alias for mailboxToken */
-    jmapToken?: string;
+    mailboxToken: string;
     /** Base URL for this mailbox service, e.g. https://meshmail.ai */
-    baseUrl?: string;
-    /** @deprecated legacy alias for baseUrl */
-    jmapUrl?: string;
-    /** Optional HTTP send base URL. Defaults to baseUrl and is used for same-domain send fallback via /api/send. */
+    baseUrl: string;
+    /** Optional AAMP discovery base URL. Defaults to baseUrl and is used for same-domain send fallback via /.well-known/aamp + aamp.mailbox.send. */
     httpSendBaseUrl?: string;
     /** SMTP submission host. If omitted, derived from baseUrl. */
     smtpHost?: string;
@@ -138,7 +169,7 @@ export interface AampMailboxIdentityConfig {
     email: string;
     /** Mailbox SMTP/JMAP password */
     smtpPassword: string;
-    /** Optional base URL for JMAP and same-domain HTTP send fallback.
+    /** Optional base URL for JMAP and same-domain AAMP HTTP send fallback.
      *  Defaults to https://<email-domain>. */
     baseUrl?: string;
     /** SMTP submission port (default: 587) */
@@ -170,19 +201,37 @@ export interface RegisteredMailboxIdentity {
     smtpPassword: string;
     baseUrl: string;
 }
+export interface AgentDirectoryEntry {
+    email: string;
+    summary: string | null;
+}
+export interface AgentDirectorySearchEntry extends AgentDirectoryEntry {
+    score: number;
+}
+export interface AgentDirectoryProfile extends AgentDirectoryEntry {
+    cardText: string | null;
+}
 export interface SendTaskOptions {
     /** Target node email */
     to: string;
     taskId?: string;
     title: string;
     bodyText?: string;
-    timeoutSecs?: number;
+    priority?: TaskPriority;
+    /** Absolute expiry timestamp. */
+    expiresAt?: string;
     contextLinks?: string[];
     dispatchContext?: Record<string, string>;
     parentTaskId?: string;
     /** Attachments to include with the dispatch email */
     attachments?: AampAttachment[];
 }
+export interface SendCancelOptions {
+    to: string;
+    taskId: string;
+    bodyText?: string;
+    inReplyTo?: string;
+}
 export interface SendResultOptions {
     /** Send to: the original from address of the dispatch email */
     to: string;
@@ -208,13 +257,39 @@ export interface SendHelpOptions {
     /** Attachments to include with the help email */
     attachments?: AampAttachment[];
 }
+export interface SendCardQueryOptions {
+    to: string;
+    taskId?: string;
+    bodyText?: string;
+    inReplyTo?: string;
+}
+export interface SendCardResponseOptions {
+    to: string;
+    taskId: string;
+    summary: string;
+    bodyText: string;
+    inReplyTo?: string;
+}
+export interface DirectoryListOptions {
+    scope?: string;
+    includeSelf?: boolean;
+    limit?: number;
+}
+export interface DirectorySearchOptions extends DirectoryListOptions {
+    query: string;
+}
+export interface UpdateDirectoryProfileOptions {
+    summary?: string | null;
+    cardText?: string | null;
+}
 export interface AampClientEvents {
     'task.dispatch': (task: TaskDispatch) => void;
+    'task.cancel': (task: TaskCancel) => void;
     'task.result': (result: TaskResult) => void;
     'task.help_needed': (help: TaskHelp) => void;
-    /** @deprecated compatibility alias for task.help_needed */
-    'task.help': (help: TaskHelp) => void;
     'task.ack': (ack: TaskAck) => void;
+    'card.query': (query: CardQuery) => void;
+    'card.response': (response: CardResponse) => void;
     /** Emitted when a standard email reply (no X-AAMP headers) is received for a known thread.
      *  Use inReplyTo to look up the taskId in your own store (Redis / DB). */
     'reply': (reply: HumanReply) => void;
@@ -222,4 +297,3 @@ export interface AampClientEvents {
     disconnected: (reason: string) => void;
     error: (err: Error) => void;
 }
-//# sourceMappingURL=types.d.ts.map

package/dist/types.js

@@ -9,9 +9,10 @@ export const AAMP_HEADER = {
     VERSION: 'X-AAMP-Version',
     INTENT: 'X-AAMP-Intent',
     TASK_ID: 'X-AAMP-TaskId',
-    TIMEOUT: 'X-AAMP-Timeout',
     CONTEXT_LINKS: 'X-AAMP-ContextLinks',
     DISPATCH_CONTEXT: 'X-AAMP-Dispatch-Context',
+    PRIORITY: 'X-AAMP-Priority',
+    EXPIRES_AT: 'X-AAMP-Expires-At',
     STATUS: 'X-AAMP-Status',
     OUTPUT: 'X-AAMP-Output',
     ERROR_MSG: 'X-AAMP-ErrorMsg',
@@ -20,5 +21,6 @@ export const AAMP_HEADER = {
     BLOCKED_REASON: 'X-AAMP-BlockedReason',
     SUGGESTED_OPTIONS: 'X-AAMP-SuggestedOptions',
     PARENT_TASK_ID: 'X-AAMP-ParentTaskId',
+    CARD_SUMMARY: 'X-AAMP-Card-Summary',
 };
 //# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAA;AAa1C,wDAAwD;AACxD,wBAAwB;AACxB,wDAAwD;AACxD,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,OAAO,EAAE,gBAAgB;IACzB,MAAM,EAAE,eAAe;IACvB,OAAO,EAAE,eAAe;IACxB,OAAO,EAAE,gBAAgB;IACzB,aAAa,EAAE,qBAAqB;IACpC,gBAAgB,EAAE,yBAAyB;IAC3C,MAAM,EAAE,eAAe;IACvB,MAAM,EAAE,eAAe;IACvB,SAAS,EAAE,iBAAiB;IAC5B,iBAAiB,EAAE,yBAAyB;IAC5C,QAAQ,EAAE,iBAAiB;IAC3B,cAAc,EAAE,sBAAsB;IACtC,iBAAiB,EAAE,yBAAyB;IAC5C,cAAc,EAAE,qBAAqB;CAC7B,CAAA"}
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAA;AAuB1C,wDAAwD;AACxD,wBAAwB;AACxB,wDAAwD;AACxD,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,OAAO,EAAE,gBAAgB;IACzB,MAAM,EAAE,eAAe;IACvB,OAAO,EAAE,eAAe;IACxB,aAAa,EAAE,qBAAqB;IACpC,gBAAgB,EAAE,yBAAyB;IAC3C,QAAQ,EAAE,iBAAiB;IAC3B,UAAU,EAAE,mBAAmB;IAC/B,MAAM,EAAE,eAAe;IACvB,MAAM,EAAE,eAAe;IACvB,SAAS,EAAE,iBAAiB;IAC5B,iBAAiB,EAAE,yBAAyB;IAC5C,QAAQ,EAAE,iBAAiB;IAC3B,cAAc,EAAE,sBAAsB;IACtC,iBAAiB,EAAE,yBAAyB;IAC5C,cAAc,EAAE,qBAAqB;IACrC,YAAY,EAAE,qBAAqB;CAC3B,CAAA"}

package/package.json

@@ -4,7 +4,7 @@
     "dist"
   ],
   "license": "MIT",
-  "version": "0.1.12",
+  "version": "0.1.14",
   "description": "AAMP SDK — Node.js client for Agent-to-Agent task collaboration over email",
   "type": "module",
   "main": "dist/index.js",