aamp-sdk 0.1.24 → 0.1.26

package/README.md

@@ -36,8 +36,11 @@ client.on('task.dispatch', async (task) => {
 
   await client.appendStreamEvent({
     streamId: stream.streamId,
-    type: 'status',
-    payload: { stage: 'running' },
+    type: 'todo',
+    payload: {
+      items: [{ id: 'task', content: 'Processing request', status: 'in_progress' }],
+      summary: 'Processing request',
+    },
   })
 
   await client.sendResult({
@@ -65,7 +68,7 @@ The SDK supports the AAMP realtime stream capability announced from
 
 - `createStream()` creates or reuses the active stream for a task
 - `sendStreamOpened()` sends the mailbox notification intent
-- `appendStreamEvent()` appends `text.delta`, `progress`, `status`, `artifact`, `todo`, `error`, or `done`
+- `appendStreamEvent()` appends `text.delta`, `todo`, `tool_call`, or `artifact`
 - `closeStream()` closes the stream before the final `task.result`
 
 Stream events use a stable AAMP envelope:
@@ -78,7 +81,7 @@ Stream events use a stable AAMP envelope:
   seq: 1,
   timestamp: '2026-06-10T10:00:00.000Z',
   type: 'text.delta',
-  payload: { text: 'Hello', channel: 'assistant' },
+  payload: { text: 'Hello' },
 }
 ```
 
@@ -87,33 +90,33 @@ and bridge cards render consistently:
 
 | Type | Payload fields used by cards |
 | --- | --- |
-| `text.delta` | `{ text: string, channel?: "assistant" | "reasoning" | "tool" | "system" | "debug", messageId?: string }` appends visible agent text. |
-| `status` | `{ label: string, state?: string, detail?: string }` renders a phase line such as "Agent is planning". |
-| `progress` | `{ label: string, value?: number, status?: "pending" | "in_progress" | "running" | "completed" | "failed", toolCallId?: string, title?: string, kind?: string, chunk?: string }` renders tool/progress activity. |
+| `text.delta` | `{ text: string, messageId?: string, sourceEvent?: string }` appends visible agent text. |
+| `todo` | `{ items: Array<{ id: string, content: string, status: "pending" | "in_progress" | "completed" }>, summary?: string }` replaces the pinned task list in agent cards. |
+| `tool_call` | `{ toolCallId: string, label: string, status: "pending" | "running" | "completed" | "failed", input?: string, output?: string }` renders tool activity. |
 | `artifact` | `{ label: string, artifactId?: string, filename?: string, contentType?: string, url?: string, size?: number, kind?: string }` announces a produced artifact. |
-| `todo` | `{ items: Array<{ id: string, content: string, status: "pending" | "in_progress" | "completed" }>, kind?: "added" | "updated" | "resumed", lastChange?: object, counts?: object, summary?: string }` updates the pinned task list in agent cards. |
-| `error` | `{ message: string, code?: string, recoverable?: boolean }` renders a stream error. |
-| `done` | `{ status: "completed" | "rejected" | "cancelled", reason?: string, error?: string, output?: string }` marks the observation stream terminal. The authoritative completion is still `task.result`. |
 
 Minimal custom-agent stream:
 
 ```ts
 await client.appendStreamEvent({
   streamId: stream.streamId,
-  type: 'status',
-  payload: { label: 'Agent is planning', state: 'running' },
+  type: 'todo',
+  payload: {
+    items: [{ id: 'plan', content: 'Plan the next step', status: 'in_progress' }],
+    summary: 'Agent is planning',
+  },
 })
 
 await client.appendStreamEvent({
   streamId: stream.streamId,
   type: 'text.delta',
-  payload: { text: 'I found the issue.', channel: 'assistant' },
+  payload: { text: 'I found the issue.' },
 })
 
 await client.appendStreamEvent({
   streamId: stream.streamId,
-  type: 'progress',
-  payload: { label: 'Tool completed: tests', status: 'completed', toolCallId: 'tests' },
+  type: 'tool_call',
+  payload: { toolCallId: 'tests', label: 'Tool completed: tests', status: 'completed' },
 })
 
 await client.closeStream({

package/dist/index.d.ts

@@ -12,6 +12,6 @@ export { JmapPushClient } from './jmap-push.js';
 export { SmtpSender, deriveMailboxServiceDefaults } from './smtp-sender.js';
 export { renderThreadHistoryForAgent } from './thread.js';
 export { DEFAULT_PAIRING_WEB_URL, buildPairingWebUrl, buildPairingUrl, consumePairingCode, createPairedSenderPolicy, createPairingCode, isPairingUrl, matchPairedSenderPolicy, normalizeDispatchContextRules, pairingUrlToWebUrl, parsePairingUrl, upsertPairedSenderPolicy, } from './pairing.js';
-export type { AampIntent, TaskStatus, AampAttachment, ReceivedAttachment, StructuredResultField, TaskDispatch, TaskCancel, TaskResult, TaskHelp, TaskAck, TaskStreamOpened, PairRequest, PairRespond, CardQuery, CardResponse, HumanReply, AampStreamEventType, AampStreamEvent, AampStreamPayloadByType, AampTextDeltaStreamPayload, AampStatusStreamPayload, AampProgressStreamPayload, AampArtifactStreamPayload, AampTodoStreamPayload, AampTodoStreamItem, AampErrorStreamPayload, AampDoneStreamPayload, AampStreamTextChannel, AampStreamProgressStatus, AampStreamDoneStatus, AampTodoItemStatus, AppendStreamEventOptions, CreateStreamOptions, CreateStreamResult, CloseStreamOptions, TaskStreamState, StreamSubscription, AgentDirectoryEntry, AgentDirectorySearchEntry, AgentDirectoryProfile, AampThreadEvent, AampMessage, AampClientConfig, AampMailboxIdentityConfig, AampDiscoveryDocument, GetThreadHistoryOptions, HydratedTaskDispatch, RegisterMailboxOptions, RegisteredMailboxIdentity, RegisteredCommandDispatchPayload, RegisteredCommandInputRef, RegisteredCommandStreamMode, AampClientEvents, SendRegisteredCommandOptions, SendTaskOptions, SendCancelOptions, SendResultOptions, SendHelpOptions, SendPairRequestOptions, SendPairRespondOptions, SendCardQueryOptions, SendCardResponseOptions, GetTaskStreamOptions, DirectoryListOptions, DirectorySearchOptions, TaskThreadHistory, UpdateDirectoryProfileOptions, } from './types.js';
+export type { AampIntent, TaskStatus, AampAttachment, ReceivedAttachment, StructuredResultField, TaskDispatch, TaskCancel, TaskResult, TaskHelp, TaskAck, TaskStreamOpened, PairRequest, PairRespond, CardQuery, CardResponse, HumanReply, AampStreamEventType, AampStreamEvent, AampStreamPayloadByType, AampTextDeltaStreamPayload, AampToolCallStreamPayload, AampArtifactStreamPayload, AampTodoStreamPayload, AampTodoStreamItem, AampStreamProgressStatus, AampTodoItemStatus, AppendStreamEventOptions, CreateStreamOptions, CreateStreamResult, CloseStreamOptions, TaskStreamState, StreamSubscription, AgentDirectoryEntry, AgentDirectorySearchEntry, AgentDirectoryProfile, AampThreadEvent, AampMessage, AampClientConfig, AampMailboxIdentityConfig, AampDiscoveryDocument, GetThreadHistoryOptions, HydratedTaskDispatch, RegisterMailboxOptions, RegisteredMailboxIdentity, RegisteredCommandDispatchPayload, RegisteredCommandInputRef, RegisteredCommandStreamMode, AampClientEvents, SendRegisteredCommandOptions, SendTaskOptions, SendCancelOptions, SendResultOptions, SendHelpOptions, SendPairRequestOptions, SendPairRespondOptions, SendCardQueryOptions, SendCardResponseOptions, GetTaskStreamOptions, DirectoryListOptions, DirectorySearchOptions, TaskThreadHistory, UpdateDirectoryProfileOptions, } from './types.js';
 export type { ConsumePairingCodeOptions, CreatePairingCodeOptions, DispatchContextRules, PairingCode, PairingUrlPayload, PairableSenderLike, PairedSenderPolicy, } from './pairing.js';
 export { AAMP_HEADER, AAMP_PROTOCOL_VERSION } from './types.js';

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,qBAAqB,EACrB,wBAAwB,EACxB,0BAA0B,EAC1B,8BAA8B,GAC/B,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,EAAE,UAAU,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAA;AAC3E,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAA;AACzD,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,wBAAwB,EACxB,iBAAiB,EACjB,YAAY,EACZ,uBAAuB,EACvB,6BAA6B,EAC7B,kBAAkB,EAClB,eAAe,EACf,wBAAwB,GACzB,MAAM,cAAc,CAAA;AAkFrB,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAA;AACxC,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EAChB,eAAe,EACf,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,qBAAqB,EACrB,wBAAwB,EACxB,0BAA0B,EAC1B,8BAA8B,GAC/B,MAAM,aAAa,CAAA;AACpB,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,EAAE,UAAU,EAAE,4BAA4B,EAAE,MAAM,kBAAkB,CAAA;AAC3E,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAA;AACzD,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,wBAAwB,EACxB,iBAAiB,EACjB,YAAY,EACZ,uBAAuB,EACvB,6BAA6B,EAC7B,kBAAkB,EAClB,eAAe,EACf,wBAAwB,GACzB,MAAM,cAAc,CAAA;AA6ErB,OAAO,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAA"}

package/dist/types.d.ts

@@ -423,31 +423,20 @@ export interface CreateStreamResult {
     openedAt?: string;
     closedAt?: string;
 }
-export type AampStreamEventType = 'text.delta' | 'progress' | 'status' | 'artifact' | 'todo' | 'error' | 'done';
-export type AampStreamTextChannel = 'assistant' | 'reasoning' | 'tool' | 'system' | 'debug' | (string & {});
-export type AampStreamProgressStatus = 'pending' | 'in_progress' | 'running' | 'completed' | 'failed' | (string & {});
-export type AampStreamDoneStatus = 'completed' | 'rejected' | 'cancelled' | (string & {});
-export type AampTodoItemStatus = 'pending' | 'in_progress' | 'completed' | (string & {});
+export type AampStreamEventType = 'text.delta' | 'todo' | 'tool_call' | 'artifact';
+export type AampStreamProgressStatus = 'pending' | 'running' | 'completed' | 'failed';
+export type AampTodoItemStatus = 'pending' | 'in_progress' | 'completed';
 export interface AampTextDeltaStreamPayload {
     text: string;
-    channel?: AampStreamTextChannel;
     messageId?: string;
     sourceEvent?: string;
 }
-export interface AampStatusStreamPayload {
+export interface AampToolCallStreamPayload {
+    toolCallId: string;
     label: string;
-    state?: string;
-    detail?: string;
-}
-export interface AampProgressStreamPayload {
-    label: string;
-    value?: number;
-    status?: AampStreamProgressStatus;
-    toolCallId?: string;
-    title?: string;
-    kind?: string;
-    chunk?: string;
-    locations?: unknown[];
+    status: AampStreamProgressStatus;
+    input?: string;
+    output?: string;
 }
 export interface AampArtifactStreamPayload {
     label: string;
@@ -462,45 +451,16 @@ export interface AampTodoStreamItem {
     id: string;
     content: string;
     status: AampTodoItemStatus;
-    createdAtMs?: number;
-    updatedAtMs?: number;
 }
 export interface AampTodoStreamPayload {
     items: AampTodoStreamItem[];
-    kind?: 'added' | 'updated' | 'resumed' | 'completed' | 'in_progress' | (string & {});
-    lastChange?: {
-        id?: string;
-        previousStatus?: AampTodoItemStatus;
-        status?: AampTodoItemStatus;
-    };
-    counts?: {
-        total?: number;
-        pending?: number;
-        inProgress?: number;
-        completed?: number;
-    };
     summary?: string;
 }
-export interface AampErrorStreamPayload {
-    message: string;
-    code?: string;
-    error?: string;
-    recoverable?: boolean;
-}
-export interface AampDoneStreamPayload {
-    status: AampStreamDoneStatus;
-    reason?: string;
-    error?: string;
-    output?: string;
-}
 export interface AampStreamPayloadByType {
     'text.delta': AampTextDeltaStreamPayload;
-    progress: AampProgressStreamPayload;
-    status: AampStatusStreamPayload;
-    artifact: AampArtifactStreamPayload;
     todo: AampTodoStreamPayload;
-    error: AampErrorStreamPayload;
-    done: AampDoneStreamPayload;
+    tool_call: AampToolCallStreamPayload;
+    artifact: AampArtifactStreamPayload;
 }
 export interface AampStreamEvent {
     id?: string;

package/package.json

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