aamp-sdk 0.1.5

package/dist/types.d.ts

@@ -0,0 +1,168 @@
+/**
+ * AAMP SDK Type Definitions
+ */
+export type AampIntent = 'task.dispatch' | 'task.result' | 'task.help' | 'task.ack';
+export type TaskStatus = 'pending' | 'running' | 'completed' | 'rejected' | 'failed' | 'timeout' | 'help_needed';
+export declare const AAMP_HEADER: {
+    readonly INTENT: "X-AAMP-Intent";
+    readonly TASK_ID: "X-AAMP-TaskId";
+    readonly TIMEOUT: "X-AAMP-Timeout";
+    readonly CONTEXT_LINKS: "X-AAMP-ContextLinks";
+    readonly STATUS: "X-AAMP-Status";
+    readonly OUTPUT: "X-AAMP-Output";
+    readonly ERROR_MSG: "X-AAMP-ErrorMsg";
+    readonly STRUCTURED_RESULT: "X-AAMP-StructuredResult";
+    readonly QUESTION: "X-AAMP-Question";
+    readonly BLOCKED_REASON: "X-AAMP-BlockedReason";
+    readonly SUGGESTED_OPTIONS: "X-AAMP-SuggestedOptions";
+    readonly PARENT_TASK_ID: "X-AAMP-ParentTaskId";
+};
+export interface StructuredResultField {
+    fieldKey: string;
+    fieldTypeKey: string;
+    value?: unknown;
+    fieldAlias?: string;
+    index?: string;
+    attachmentFilenames?: string[];
+}
+export interface TaskDispatch {
+    intent: 'task.dispatch';
+    taskId: string;
+    title: string;
+    timeoutSecs: number;
+    contextLinks: string[];
+    parentTaskId?: string;
+    from: string;
+    to: string;
+    messageId: string;
+    subject: string;
+    /** Plain-text body of the email (task description) */
+    bodyText: string;
+    /** Attachments received with this dispatch (use blobId to download) */
+    attachments?: ReceivedAttachment[];
+}
+export interface TaskResult {
+    intent: 'task.result';
+    taskId: string;
+    status: 'completed' | 'rejected';
+    output: string;
+    errorMsg?: string;
+    structuredResult?: StructuredResultField[];
+    from: string;
+    to: string;
+    /** True when the reply came from a standard email client (no X-AAMP-Intent header).
+     *  taskId was resolved via In-Reply-To → Message-ID reverse lookup. */
+    isHumanReply?: boolean;
+    /** Attachments received with this result (use blobId to download) */
+    attachments?: ReceivedAttachment[];
+}
+export interface HumanReply {
+    /** Message-ID of the email being replied to — use this to look up the taskId */
+    inReplyTo: string;
+    /** This reply email's own Message-ID */
+    messageId: string;
+    from: string;
+    to: string;
+    subject: string;
+    /** Plain-text body of the reply */
+    bodyText: string;
+}
+export interface TaskHelp {
+    intent: 'task.help';
+    taskId: string;
+    question: string;
+    blockedReason: string;
+    suggestedOptions: string[];
+    from: string;
+    to: string;
+}
+export interface TaskAck {
+    intent: 'task.ack';
+    taskId: string;
+    from: string;
+    to: string;
+}
+/** Attachment for sending (binary content) */
+export interface AampAttachment {
+    filename: string;
+    contentType: string;
+    content: Buffer | string;
+    size?: number;
+}
+/** Attachment metadata received via JMAP (use blobId to download) */
+export interface ReceivedAttachment {
+    filename: string;
+    contentType: string;
+    size: number;
+    blobId: string;
+}
+export type AampMessage = TaskDispatch | TaskResult | TaskHelp | TaskAck | HumanReply;
+export interface AampClientConfig {
+    /** Node email address, e.g. codereviewer-abc123@aamp.yourdomain.com */
+    email: string;
+    /** Base64(email:smtpPassword) — returned by management service on agent creation */
+    jmapToken: string;
+    /** Stalwart base URL, e.g. http://localhost:8080 */
+    jmapUrl: string;
+    /** Optional HTTP send base URL. Defaults to jmapUrl and is used for same-domain send fallback via /api/send. */
+    httpSendBaseUrl?: string;
+    /** SMTP submission host */
+    smtpHost: string;
+    /** SMTP submission port (default: 587) */
+    smtpPort?: number;
+    /** SMTP password (returned by management service on agent creation) */
+    smtpPassword: string;
+    /** How often to retry failed JMAP connection (ms, default: 5000) */
+    reconnectInterval?: number;
+    /** Whether to reject unauthorized TLS certificates (default: true).
+     *  Set to false only for development with self-signed certificates. */
+    rejectUnauthorized?: boolean;
+}
+export interface SendTaskOptions {
+    /** Target node email */
+    to: string;
+    title: string;
+    timeoutSecs?: number;
+    contextLinks?: string[];
+    parentTaskId?: string;
+    /** Attachments to include with the dispatch email */
+    attachments?: AampAttachment[];
+}
+export interface SendResultOptions {
+    /** Send to: the original from address of the dispatch email */
+    to: string;
+    taskId: string;
+    status: 'completed' | 'rejected';
+    output: string;
+    errorMsg?: string;
+    structuredResult?: StructuredResultField[];
+    /** Message-ID of the dispatch email, for In-Reply-To threading */
+    inReplyTo?: string;
+    /** Attachments to include with the result email */
+    attachments?: AampAttachment[];
+}
+export interface SendHelpOptions {
+    /** Send to: the original from address of the dispatch email */
+    to: string;
+    taskId: string;
+    question: string;
+    blockedReason: string;
+    suggestedOptions: string[];
+    /** Message-ID of the dispatch email, for In-Reply-To threading */
+    inReplyTo?: string;
+    /** Attachments to include with the help email */
+    attachments?: AampAttachment[];
+}
+export interface AampClientEvents {
+    'task.dispatch': (task: TaskDispatch) => void;
+    'task.result': (result: TaskResult) => void;
+    'task.help': (help: TaskHelp) => void;
+    'task.ack': (ack: TaskAck) => 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;
+    connected: () => void;
+    disconnected: (reason: string) => void;
+    error: (err: Error) => void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,21 @@
+/**
+ * AAMP SDK Type Definitions
+ */
+// =====================================================
+// AAMP Header constants
+// =====================================================
+export const AAMP_HEADER = {
+    INTENT: 'X-AAMP-Intent',
+    TASK_ID: 'X-AAMP-TaskId',
+    TIMEOUT: 'X-AAMP-Timeout',
+    CONTEXT_LINKS: 'X-AAMP-ContextLinks',
+    STATUS: 'X-AAMP-Status',
+    OUTPUT: 'X-AAMP-Output',
+    ERROR_MSG: 'X-AAMP-ErrorMsg',
+    STRUCTURED_RESULT: 'X-AAMP-StructuredResult',
+    QUESTION: 'X-AAMP-Question',
+    BLOCKED_REASON: 'X-AAMP-BlockedReason',
+    SUGGESTED_OPTIONS: 'X-AAMP-SuggestedOptions',
+    PARENT_TASK_ID: 'X-AAMP-ParentTaskId',
+};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAaH,wDAAwD;AACxD,wBAAwB;AACxB,wDAAwD;AACxD,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,MAAM,EAAE,eAAe;IACvB,OAAO,EAAE,eAAe;IACxB,OAAO,EAAE,gBAAgB;IACzB,aAAa,EAAE,qBAAqB;IACpC,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"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "aamp-sdk",
+  "files": [
+    "dist"
+  ],
+  "license": "MIT",
+  "version": "0.1.5",
+  "description": "AAMP SDK — Node.js client for Agent-to-Agent task collaboration over email",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "scripts": {
+    "dev": "tsx watch src/index.ts",
+    "build": "tsc",
+    "test": "vitest run",
+    "lint": "eslint src --ext .ts"
+  },
+  "dependencies": {
+    "ws": "^8.16.0",
+    "nodemailer": "^6.9.10"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.30",
+    "@types/nodemailer": "^6.4.14",
+    "@types/ws": "^8.5.10",
+    "tsx": "^4.7.1",
+    "typescript": "^5.4.3",
+    "vitest": "^1.4.0"
+  }
+}