aamp-sdk 0.1.14 → 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":"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"}

package/dist/types.d.ts

@@ -1,8 +1,8 @@
 /**
  * AAMP SDK Type Definitions
  */
-export declare const AAMP_PROTOCOL_VERSION = "1.0";
-export type AampIntent = 'task.dispatch' | 'task.cancel' | 'task.result' | 'task.help_needed' | 'task.ack' | 'card.query' | 'card.response';
+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: {
@@ -20,6 +20,7 @@ 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";
 };
@@ -107,6 +108,15 @@ 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';
@@ -142,7 +152,7 @@ export interface ReceivedAttachment {
     size: number;
     blobId: string;
 }
-export type AampMessage = TaskDispatch | TaskCancel | TaskResult | TaskHelp | TaskAck | CardQuery | CardResponse | 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;
@@ -188,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 */
@@ -211,6 +231,29 @@ export interface AgentDirectorySearchEntry extends AgentDirectoryEntry {
 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;
@@ -270,6 +313,49 @@ export interface SendCardResponseOptions {
     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;
@@ -288,6 +374,7 @@ export interface AampClientEvents {
     'task.result': (result: TaskResult) => void;
     'task.help_needed': (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.

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
 // =====================================================
@@ -20,6 +20,7 @@ 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',
 };

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;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"}
+{"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.14",
+  "version": "0.1.15",
   "description": "AAMP SDK — Node.js client for Agent-to-Agent task collaboration over email",
   "type": "module",
   "main": "dist/index.js",