aamp-sdk 0.1.13 → 0.1.15

package/dist/thread.js

@@ -0,0 +1,53 @@
+function singleLine(value, maxLength = 220) {
+    const normalized = (value ?? '').replace(/\s+/g, ' ').trim();
+    if (!normalized)
+        return '';
+    if (normalized.length <= maxLength)
+        return normalized;
+    return `${normalized.slice(0, maxLength - 1)}…`;
+}
+function formatTimestamp(value) {
+    const date = new Date(value);
+    if (Number.isNaN(date.getTime()))
+        return value;
+    return date.toISOString().slice(0, 16).replace('T', ' ');
+}
+function renderEventLine(event) {
+    const from = event.from.split('@')[0] || event.from;
+    const timestamp = formatTimestamp(event.createdAt);
+    if (event.intent === 'task.dispatch') {
+        const summary = singleLine(event.bodyText) || singleLine(event.title) || 'Task dispatched';
+        return `[${timestamp}] ${from} dispatched: ${summary}`;
+    }
+    if (event.intent === 'task.help_needed') {
+        const question = singleLine(event.question) || 'Asked for help';
+        const reason = singleLine(event.blockedReason);
+        return `[${timestamp}] ${from} asked for help: ${question}${reason ? ` (reason: ${reason})` : ''}`;
+    }
+    if (event.intent === 'task.result') {
+        const output = singleLine(event.output) || singleLine(event.bodyText) || 'Sent a result';
+        return `[${timestamp}] ${from} replied: ${output}`;
+    }
+    if (event.intent === 'task.cancel') {
+        const body = singleLine(event.bodyText) || 'Cancelled the task';
+        return `[${timestamp}] ${from} cancelled the task: ${body}`;
+    }
+    if (event.intent === 'task.ack') {
+        return `[${timestamp}] ${from} acknowledged the task`;
+    }
+    return `[${timestamp}] ${from}: ${singleLine(event.bodyText) || event.intent}`;
+}
+export function renderThreadHistoryForAgent(events, options = {}) {
+    const filtered = events.filter((event) => event.intent !== 'task.stream.opened');
+    if (filtered.length === 0)
+        return '';
+    const maxEvents = Math.max(1, options.maxEvents ?? 8);
+    const visible = filtered.slice(-maxEvents);
+    const omitted = filtered.length - visible.length;
+    return [
+        'Prior thread context:',
+        ...(omitted > 0 ? [`(${omitted} earlier event(s) omitted)`] : []),
+        ...visible.map((event) => `- ${renderEventLine(event)}`),
+    ].join('\n');
+}
+//# sourceMappingURL=thread.js.map

package/dist/thread.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thread.js","sourceRoot":"","sources":["../src/thread.ts"],"names":[],"mappings":"AAMA,SAAS,UAAU,CAAC,KAAqB,EAAE,SAAS,GAAG,GAAG;IACxD,MAAM,UAAU,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAA;IAC5D,IAAI,CAAC,UAAU;QAAE,OAAO,EAAE,CAAA;IAC1B,IAAI,UAAU,CAAC,MAAM,IAAI,SAAS;QAAE,OAAO,UAAU,CAAA;IACrD,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,GAAG,CAAA;AACjD,CAAC;AAED,SAAS,eAAe,CAAC,KAAa;IACpC,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,KAAK,CAAC,CAAA;IAC5B,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAAE,OAAO,KAAK,CAAA;IAC9C,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;AAC1D,CAAC;AAED,SAAS,eAAe,CAAC,KAAsB;IAC7C,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,IAAI,CAAA;IACnD,MAAM,SAAS,GAAG,eAAe,CAAC,KAAK,CAAC,SAAS,CAAC,CAAA;IAElD,IAAI,KAAK,CAAC,MAAM,KAAK,eAAe,EAAE,CAAC;QACrC,MAAM,OAAO,GAAG,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,iBAAiB,CAAA;QAC1F,OAAO,IAAI,SAAS,KAAK,IAAI,gBAAgB,OAAO,EAAE,CAAA;IACxD,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,kBAAkB,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,gBAAgB,CAAA;QAC/D,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,aAAa,CAAC,CAAA;QAC9C,OAAO,IAAI,SAAS,KAAK,IAAI,oBAAoB,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,aAAa,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAA;IACpG,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;QACnC,MAAM,MAAM,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,eAAe,CAAA;QACxF,OAAO,IAAI,SAAS,KAAK,IAAI,aAAa,MAAM,EAAE,CAAA;IACpD,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,aAAa,EAAE,CAAC;QACnC,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,oBAAoB,CAAA;QAC/D,OAAO,IAAI,SAAS,KAAK,IAAI,wBAAwB,IAAI,EAAE,CAAA;IAC7D,CAAC;IAED,IAAI,KAAK,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QAChC,OAAO,IAAI,SAAS,KAAK,IAAI,wBAAwB,CAAA;IACvD,CAAC;IAED,OAAO,IAAI,SAAS,KAAK,IAAI,KAAK,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,MAAM,EAAE,CAAA;AAChF,CAAC;AAED,MAAM,UAAU,2BAA2B,CACzC,MAAyB,EACzB,UAAsC,EAAE;IAExC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,oBAAoB,CAAC,CAAA;IAChF,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAA;IAEpC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,CAAC,SAAS,IAAI,CAAC,CAAC,CAAA;IACrD,MAAM,OAAO,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,CAAA;IAC1C,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAA;IAEhD,OAAO;QACL,uBAAuB;QACvB,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,OAAO,4BAA4B,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACjE,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;KACzD,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACd,CAAC"}

package/dist/tiny-emitter.d.ts

@@ -9,4 +9,3 @@ export declare class TinyEmitter<Events extends object> {
     protected emit<K extends keyof Events>(event: K, ...args: EventArgs<Events, K>): boolean;
 }
 export {};
-//# sourceMappingURL=tiny-emitter.d.ts.map

package/dist/types.d.ts

@@ -1,16 +1,18 @@
 /**
  * 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 declare const AAMP_PROTOCOL_VERSION = "1.1";
+export type AampIntent = 'task.dispatch' | 'task.cancel' | 'task.result' | 'task.help_needed' | 'task.ack' | 'task.stream.opened' | '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";
@@ -18,7 +20,9 @@ export declare const AAMP_HEADER: {
     readonly QUESTION: "X-AAMP-Question";
     readonly BLOCKED_REASON: "X-AAMP-BlockedReason";
     readonly SUGGESTED_OPTIONS: "X-AAMP-SuggestedOptions";
+    readonly STREAM_ID: "X-AAMP-Stream-Id";
     readonly PARENT_TASK_ID: "X-AAMP-ParentTaskId";
+    readonly CARD_SUMMARY: "X-AAMP-Card-Summary";
 };
 export interface StructuredResultField {
     fieldKey: string;
@@ -33,7 +37,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 +51,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 +108,36 @@ export interface TaskAck {
     to: string;
     messageId?: string;
 }
+export interface TaskStreamOpened {
+    protocolVersion: string;
+    intent: 'task.stream.opened';
+    taskId: string;
+    streamId: string;
+    from: string;
+    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 +152,15 @@ export interface ReceivedAttachment {
     size: number;
     blobId: string;
 }
-export type AampMessage = TaskDispatch | TaskResult | TaskHelp | TaskAck | HumanReply;
+export type AampMessage = TaskDispatch | TaskCancel | TaskResult | TaskHelp | TaskAck | TaskStreamOpened | 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 +179,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) */
@@ -157,6 +198,16 @@ export interface AampDiscoveryDocument {
         actions?: string[];
     };
     endpoints?: Record<string, string>;
+    capabilities?: {
+        stream?: {
+            transport: 'sse';
+            createAction?: string;
+            appendAction?: string;
+            closeAction?: string;
+            getAction?: string;
+            subscribeUrlTemplate?: string;
+        };
+    };
 }
 export interface RegisterMailboxOptions {
     /** AAMP service root, e.g. https://meshmail.ai */
@@ -170,19 +221,60 @@ 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 AampThreadEvent {
+    intent: AampIntent;
+    from: string;
+    to: string;
+    title?: string | null;
+    bodyText?: string | null;
+    output?: string | null;
+    question?: string | null;
+    blockedReason?: string | null;
+    messageId?: string | null;
+    createdAt: string;
+}
+export interface GetThreadHistoryOptions {
+    includeStreamOpened?: boolean;
+}
+export interface TaskThreadHistory {
+    taskId: string;
+    events: AampThreadEvent[];
+}
+export interface HydratedTaskDispatch extends TaskDispatch {
+    threadHistory: AampThreadEvent[];
+    threadContextText: string;
+}
 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 +300,83 @@ 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 CreateStreamOptions {
+    taskId: string;
+    peerEmail: string;
+}
+export interface CreateStreamResult {
+    streamId: string;
+    taskId: string;
+    status: 'created' | 'opened' | 'closed';
+    ownerEmail: string;
+    peerEmail: string;
+    createdAt: string;
+    openedAt?: string;
+    closedAt?: string;
+}
+export type AampStreamEventType = 'text.delta' | 'progress' | 'status' | 'artifact' | 'error' | 'done';
+export interface AampStreamEvent {
+    id?: string;
+    streamId: string;
+    taskId: string;
+    seq: number;
+    timestamp: string;
+    type: AampStreamEventType;
+    payload: Record<string, unknown>;
+}
+export interface AppendStreamEventOptions {
+    streamId: string;
+    type: AampStreamEventType;
+    payload: Record<string, unknown>;
+}
+export interface CloseStreamOptions {
+    streamId: string;
+    payload?: Record<string, unknown>;
+}
+export interface GetTaskStreamOptions {
+    taskId?: string;
+    streamId?: string;
+}
+export interface TaskStreamState extends CreateStreamResult {
+    latestEvent?: AampStreamEvent;
+}
+export interface StreamSubscription {
+    close(): void;
+}
+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;
+    'task.stream.opened': (stream: TaskStreamOpened) => 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 +384,3 @@ export interface AampClientEvents {
     disconnected: (reason: string) => void;
     error: (err: Error) => void;
 }
-//# sourceMappingURL=types.d.ts.map

package/dist/types.js

@@ -1,7 +1,7 @@
 /**
  * AAMP SDK Type Definitions
  */
-export const AAMP_PROTOCOL_VERSION = '1.0';
+export const AAMP_PROTOCOL_VERSION = '1.1';
 // =====================================================
 // AAMP Header constants
 // =====================================================
@@ -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',
@@ -19,6 +20,8 @@ export const AAMP_HEADER = {
     QUESTION: 'X-AAMP-Question',
     BLOCKED_REASON: 'X-AAMP-BlockedReason',
     SUGGESTED_OPTIONS: 'X-AAMP-SuggestedOptions',
+    STREAM_ID: 'X-AAMP-Stream-Id',
     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;AAwB1C,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,SAAS,EAAE,kBAAkB;IAC7B,cAAc,EAAE,qBAAqB;IACrC,YAAY,EAAE,qBAAqB;CAC3B,CAAA"}

package/package.json

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