@microsoft/teams.a2a 2.0.0-preview.3

package/dist/common/schema.js

@@ -0,0 +1,26 @@
+"use strict";
+// From https://github.com/google/A2A/blob/main/samples/js/src/schema.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorCodeUnsupportedOperation = exports.ErrorCodePushNotificationNotSupported = exports.ErrorCodeTaskNotCancelable = exports.ErrorCodeTaskNotFound = exports.ErrorCodeInternalError = exports.ErrorCodeInvalidParams = exports.ErrorCodeMethodNotFound = exports.ErrorCodeInvalidRequest = exports.ErrorCodeParseError = void 0;
+// === Error Types (Standard and A2A)
+/** Error code for JSON Parse Error (-32700). Invalid JSON was received by the server. */
+exports.ErrorCodeParseError = -32700;
+/** Error code for Invalid Request (-32600). The JSON sent is not a valid Request object. */
+exports.ErrorCodeInvalidRequest = -32600;
+/** Error code for Method Not Found (-32601). The method does not exist / is not available. */
+exports.ErrorCodeMethodNotFound = -32601;
+/** Error code for Invalid Params (-32602). Invalid method parameter(s). */
+exports.ErrorCodeInvalidParams = -32602;
+/** Error code for Internal Error (-32603). Internal JSON-RPC error. */
+exports.ErrorCodeInternalError = -32603;
+/** Error code for Task Not Found (-32001). The specified task was not found. */
+exports.ErrorCodeTaskNotFound = -32001;
+/** Error code for Task Not Cancelable (-32002). The specified task cannot be canceled. */
+exports.ErrorCodeTaskNotCancelable = -32002;
+/** Error code for Push Notification Not Supported (-32003). Push Notifications are not supported for this operation or agent. */
+exports.ErrorCodePushNotificationNotSupported = -32003;
+/** Error code for Unsupported Operation (-32004). The requested operation is not supported by the agent. */
+exports.ErrorCodeUnsupportedOperation = -32004;
+// Subscription responses are typically event streams (TaskUpdateEvent) sent over the transport,
+// not direct JSON-RPC responses to the subscribe request itself.
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2NoZW1hLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2NvbW1vbi9zY2hlbWEudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBLHdFQUF3RTs7O0FBa2pCeEUscUNBQXFDO0FBRXJDLHlGQUF5RjtBQUM1RSxRQUFBLG1CQUFtQixHQUFHLENBQUMsS0FBSyxDQUFDO0FBRTFDLDRGQUE0RjtBQUMvRSxRQUFBLHVCQUF1QixHQUFHLENBQUMsS0FBSyxDQUFDO0FBRTlDLDhGQUE4RjtBQUNqRixRQUFBLHVCQUF1QixHQUFHLENBQUMsS0FBSyxDQUFDO0FBRTlDLDJFQUEyRTtBQUM5RCxRQUFBLHNCQUFzQixHQUFHLENBQUMsS0FBSyxDQUFDO0FBRTdDLHVFQUF1RTtBQUMxRCxRQUFBLHNCQUFzQixHQUFHLENBQUMsS0FBSyxDQUFDO0FBRzdDLGdGQUFnRjtBQUNuRSxRQUFBLHFCQUFxQixHQUFHLENBQUMsS0FBSyxDQUFDO0FBRTVDLDBGQUEwRjtBQUM3RSxRQUFBLDBCQUEwQixHQUFHLENBQUMsS0FBSyxDQUFDO0FBRWpELGlJQUFpSTtBQUNwSCxRQUFBLHFDQUFxQyxHQUFHLENBQUMsS0FBSyxDQUFDO0FBRzVELDRHQUE0RztBQUMvRixRQUFBLDZCQUE2QixHQUFHLENBQUMsS0FBSyxDQUFDO0FBaVVwRCxnR0FBZ0c7QUFDaEcsaUVBQWlFIn0=

package/dist/common/type-utils.d.ts

@@ -0,0 +1,11 @@
+export type Success<T> = {
+    success: true;
+    data: T;
+};
+export type Failure = {
+    success: false;
+    error: Error;
+};
+export type Result<T> = Success<T> | Failure;
+export type PromiseOrValue<T> = T | Promise<T>;
+export type ValueOrFactory<T> = T | (() => PromiseOrValue<T>);

package/dist/common/type-utils.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZS11dGlscy5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9jb21tb24vdHlwZS11dGlscy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiIn0=

package/dist/common/uuid.d.ts

@@ -0,0 +1 @@
+export declare function generateRequestId(): string | number;

package/dist/common/uuid.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateRequestId = generateRequestId;
+function generateRequestId() {
+    if (typeof crypto !== 'undefined' && typeof crypto.randomUUID === 'function') {
+        return crypto.randomUUID();
+    }
+    else {
+        return Date.now();
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXVpZC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9jb21tb24vdXVpZC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQUFBLDhDQU1DO0FBTkQsU0FBZ0IsaUJBQWlCO0lBQzdCLElBQUksT0FBTyxNQUFNLEtBQUssV0FBVyxJQUFJLE9BQU8sTUFBTSxDQUFDLFVBQVUsS0FBSyxVQUFVLEVBQUUsQ0FBQztRQUMzRSxPQUFPLE1BQU0sQ0FBQyxVQUFVLEVBQUUsQ0FBQztJQUMvQixDQUFDO1NBQU0sQ0FBQztRQUNKLE9BQU8sSUFBSSxDQUFDLEdBQUcsRUFBRSxDQUFDO0lBQ3RCLENBQUM7QUFDTCxDQUFDIn0=

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export * from './chat-prompt/plugin';
+export * from './chat-prompt/types';
+export * from './client/agent-client';
+export * from './client/agent-manager';
+export * from './client/agent-task-store';
+export * from './common/schema';
+export * as schema from './common/schema';
+export * from './server/plugin';
+export * from './server/types/a2a-types';
+export * from './server/types/event-types';

package/dist/index.js

@@ -0,0 +1,50 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.schema = void 0;
+__exportStar(require("./chat-prompt/plugin"), exports);
+__exportStar(require("./chat-prompt/types"), exports);
+__exportStar(require("./client/agent-client"), exports);
+__exportStar(require("./client/agent-manager"), exports);
+__exportStar(require("./client/agent-task-store"), exports);
+__exportStar(require("./common/schema"), exports);
+exports.schema = __importStar(require("./common/schema"));
+__exportStar(require("./server/plugin"), exports);
+__exportStar(require("./server/types/a2a-types"), exports);
+__exportStar(require("./server/types/event-types"), exports);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBQUEsdURBQXFDO0FBQ3JDLHNEQUFvQztBQUNwQyx3REFBc0M7QUFDdEMseURBQXVDO0FBQ3ZDLDREQUEwQztBQUMxQyxrREFBZ0M7QUFDaEMsMERBQTBDO0FBQzFDLGtEQUFnQztBQUNoQywyREFBeUM7QUFDekMsNkRBQTJDIn0=

package/dist/server/middleware/isTaskRequest.d.ts

@@ -0,0 +1,2 @@
+import express from 'express';
+export declare function isTaskRequest(): (req: express.Request, res: express.Response, next: express.NextFunction) => void;

package/dist/server/middleware/isTaskRequest.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isTaskRequest = isTaskRequest;
+const a2a_error_1 = require("../types/a2a-error");
+function isTaskRequest() {
+    return (req, res, next) => {
+        const valid = typeof req.body === 'object' &&
+            req.body !== null &&
+            req.body.jsonrpc === '2.0' &&
+            typeof req.body.method === 'string' &&
+            (req.body.id === null ||
+                typeof req.body.id === 'string' ||
+                typeof req.body.id === 'number') && // ID is required for requests needing response
+            (req.body.params === undefined ||
+                typeof req.body.params === 'object' || // Allows null, array, or object
+                Array.isArray(req.body.params));
+        if (!valid) {
+            res
+                .status(400)
+                .send(a2a_error_1.A2AError.invalidRequest('Invalid JSON-RPC request structure').toJSONRPCError());
+            return;
+        }
+        const request = req.body;
+        if (request.method === 'tasks/send') {
+            if (!request.params?.id) {
+                res.status(400).send(a2a_error_1.A2AError.invalidParams('Invalid or missing task ID').toJSONRPCError());
+            }
+        }
+        next();
+    };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaXNUYXNrUmVxdWVzdC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy9zZXJ2ZXIvbWlkZGxld2FyZS9pc1Rhc2tSZXF1ZXN0LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBS0Esc0NBK0JDO0FBakNELGtEQUE4QztBQUU5QyxTQUFnQixhQUFhO0lBQzNCLE9BQU8sQ0FBQyxHQUFvQixFQUFFLEdBQXFCLEVBQUUsSUFBMEIsRUFBRSxFQUFFO1FBQ2pGLE1BQU0sS0FBSyxHQUNULE9BQU8sR0FBRyxDQUFDLElBQUksS0FBSyxRQUFRO1lBQzVCLEdBQUcsQ0FBQyxJQUFJLEtBQUssSUFBSTtZQUNqQixHQUFHLENBQUMsSUFBSSxDQUFDLE9BQU8sS0FBSyxLQUFLO1lBQzFCLE9BQU8sR0FBRyxDQUFDLElBQUksQ0FBQyxNQUFNLEtBQUssUUFBUTtZQUNuQyxDQUFDLEdBQUcsQ0FBQyxJQUFJLENBQUMsRUFBRSxLQUFLLElBQUk7Z0JBQ25CLE9BQU8sR0FBRyxDQUFDLElBQUksQ0FBQyxFQUFFLEtBQUssUUFBUTtnQkFDL0IsT0FBTyxHQUFHLENBQUMsSUFBSSxDQUFDLEVBQUUsS0FBSyxRQUFRLENBQUMsSUFBSSwrQ0FBK0M7WUFDckYsQ0FBQyxHQUFHLENBQUMsSUFBSSxDQUFDLE1BQU0sS0FBSyxTQUFTO2dCQUM1QixPQUFPLEdBQUcsQ0FBQyxJQUFJLENBQUMsTUFBTSxLQUFLLFFBQVEsSUFBSSxnQ0FBZ0M7Z0JBQ3ZFLEtBQUssQ0FBQyxPQUFPLENBQUMsR0FBRyxDQUFDLElBQUksQ0FBQyxNQUFNLENBQUMsQ0FBQyxDQUFDO1FBRXBDLElBQUksQ0FBQyxLQUFLLEVBQUUsQ0FBQztZQUNYLEdBQUc7aUJBQ0EsTUFBTSxDQUFDLEdBQUcsQ0FBQztpQkFDWCxJQUFJLENBQUMsb0JBQVEsQ0FBQyxjQUFjLENBQUMsb0NBQW9DLENBQUMsQ0FBQyxjQUFjLEVBQUUsQ0FBQyxDQUFDO1lBQ3hGLE9BQU87UUFDVCxDQUFDO1FBRUQsTUFBTSxPQUFPLEdBQXNCLEdBQUcsQ0FBQyxJQUFJLENBQUM7UUFFNUMsSUFBSSxPQUFPLENBQUMsTUFBTSxLQUFLLFlBQVksRUFBRSxDQUFDO1lBQ3BDLElBQUksQ0FBQyxPQUFPLENBQUMsTUFBTSxFQUFFLEVBQUUsRUFBRSxDQUFDO2dCQUN4QixHQUFHLENBQUMsTUFBTSxDQUFDLEdBQUcsQ0FBQyxDQUFDLElBQUksQ0FBQyxvQkFBUSxDQUFDLGFBQWEsQ0FBQyw0QkFBNEIsQ0FBQyxDQUFDLGNBQWMsRUFBRSxDQUFDLENBQUM7WUFDOUYsQ0FBQztRQUNILENBQUM7UUFFRCxJQUFJLEVBQUUsQ0FBQztJQUNULENBQUMsQ0FBQztBQUNKLENBQUMifQ==

package/dist/server/plugin.d.ts

@@ -0,0 +1,49 @@
+import { EmitPluginEvent, HttpPlugin, IPlugin } from '@microsoft/teams.apps';
+import { ILogger, IStorage } from '@microsoft/teams.common';
+import { AgentManager, AgentManagerOptions } from '../client/agent-manager';
+import * as schema from '../common/schema';
+import { TaskManager } from './tasks/task-manager';
+import { TaskStore } from './tasks/task-store';
+import { A2AEvents } from './types/event-types';
+interface IA2APluginOptions {
+    /**
+     * The agent card to be used for the A2A plugin.
+     */
+    agentCard: schema.AgentCard;
+    /**
+     * Path to the A2A server
+     * @default '/a2a'
+     */
+    path?: `/${string}`;
+    /**
+     * taskStore which stores the tasks that are sent to the agent
+     * or that the agent sends. If not provided, the App's storage will be used.
+     */
+    taskStore?: TaskStore;
+    /**
+     * The agent manager options that can be used to configure the agent manager.
+     * @default {}
+     */
+    managerOptions?: AgentManagerOptions;
+}
+export declare class A2APlugin implements IPlugin {
+    protected readonly emit: EmitPluginEvent<A2AEvents>;
+    protected readonly _httpPlugin: HttpPlugin;
+    protected readonly _storage: IStorage;
+    protected readonly _logger: ILogger;
+    __eventType: A2AEvents;
+    protected _card: schema.AgentCard;
+    protected _path: string;
+    protected _taskManager: TaskManager;
+    protected _taskStore: TaskStore;
+    protected _clientManager: AgentManager;
+    get clientManager(): AgentManager;
+    constructor(options: IA2APluginOptions);
+    onInit(): void;
+    private onTaskRequest;
+    private onSendRequest;
+    private onGetTaskRequest;
+    private onTaskGetRequest;
+    private onTaskSendRequest;
+}
+export {};

package/dist/server/plugin.js

@@ -0,0 +1,130 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.A2APlugin = void 0;
+const express_1 = __importDefault(require("express"));
+const teams_apps_1 = require("@microsoft/teams.apps");
+const agent_manager_1 = require("../client/agent-manager");
+const isTaskRequest_1 = require("./middleware/isTaskRequest");
+const plugin_on_get_request_1 = require("./plugin.on-get-request");
+const plugin_on_send_request_1 = require("./plugin.on-send-request");
+const task_manager_1 = require("./tasks/task-manager");
+const task_store_1 = require("./tasks/task-store");
+const a2a_error_1 = require("./types/a2a-error");
+let A2APlugin = class A2APlugin {
+    emit;
+    _httpPlugin;
+    _storage;
+    _logger;
+    __eventType;
+    _card;
+    _path;
+    _taskManager;
+    _taskStore;
+    _clientManager;
+    get clientManager() {
+        return this._clientManager;
+    }
+    constructor(options) {
+        this._card = options.agentCard;
+        if (this._card.capabilities.streaming) {
+            this._logger.warn('A2APlugin does not support streaming yet, but the agent card indicates it does');
+        }
+        this._path = options.path || '/a2a';
+        this._clientManager = new agent_manager_1.AgentManager(options.managerOptions);
+        if (options.taskStore) {
+            this._taskStore = options.taskStore;
+        }
+    }
+    onInit() {
+        this._taskStore = this._taskStore ?? new task_store_1.TaskStore(this._storage);
+        this._taskManager = new task_manager_1.TaskManager(this._taskStore, this._logger);
+        this._logger.info('A2APlugin agent card available at /.well-known/agent.json');
+        this._httpPlugin.get('/.well-known/agent.json', (_req, res) => {
+            res.json(this._card);
+        });
+        this._logger.info(`A2APlugin listening on ${this._path}`);
+        this._httpPlugin.post(this._path, express_1.default.json(), (0, isTaskRequest_1.isTaskRequest)(), this.onTaskRequest.bind(this));
+    }
+    async onTaskRequest(req, res, next) {
+        const request = req.body;
+        try {
+            switch (request.method) {
+                case 'tasks/send':
+                    return this.onTaskSendRequest(request, res, next);
+                case 'tasks/sendSubscribe':
+                    throw new Error('sendSubscribe not implemented yet');
+                case 'tasks/get':
+                    return this.onTaskGetRequest(request, res, next);
+                case 'tasks/cancel':
+                    throw new Error('cancel not implemented yet');
+                default:
+                    throw a2a_error_1.A2AError.methodNotFound(request.method);
+            }
+        }
+        catch (err) {
+            if (err instanceof a2a_error_1.A2AError) {
+                err.taskId = request.id || undefined;
+            }
+            else {
+                throw a2a_error_1.A2AError.internalError('internal error', err);
+            }
+            next(err);
+        }
+    }
+    onSendRequest = plugin_on_send_request_1.onSendRequest; // eslint-disable-line @typescript-eslint/member-ordering
+    onGetTaskRequest = plugin_on_get_request_1.onGetTaskRequest; // eslint-disable-line @typescript-eslint/member-ordering
+    async onTaskGetRequest(req, res, next) {
+        await this.onGetTaskRequest(req, (result) => {
+            res.json(result);
+            if (result?.error) {
+                next(result.error);
+            }
+        });
+    }
+    async onTaskSendRequest(req, res, next) {
+        await this.onSendRequest(req, (result) => {
+            res.json(result);
+            if (result?.error) {
+                next(result.error);
+            }
+        });
+    }
+};
+exports.A2APlugin = A2APlugin;
+__decorate([
+    (0, teams_apps_1.Event)('custom'),
+    __metadata("design:type", Function)
+], A2APlugin.prototype, "emit", void 0);
+__decorate([
+    (0, teams_apps_1.Dependency)(),
+    __metadata("design:type", teams_apps_1.HttpPlugin)
+], A2APlugin.prototype, "_httpPlugin", void 0);
+__decorate([
+    (0, teams_apps_1.Storage)(),
+    __metadata("design:type", Object)
+], A2APlugin.prototype, "_storage", void 0);
+__decorate([
+    (0, teams_apps_1.Logger)(),
+    __metadata("design:type", Object)
+], A2APlugin.prototype, "_logger", void 0);
+exports.A2APlugin = A2APlugin = __decorate([
+    (0, teams_apps_1.Plugin)({
+        name: 'a2a',
+        description: 'A2A Plugin',
+        version: '1.0.0',
+    }),
+    __metadata("design:paramtypes", [Object])
+], A2APlugin);
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGx1Z2luLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3NlcnZlci9wbHVnaW4udHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7O0FBQUEsc0RBQThCO0FBRTlCLHNEQUF5SDtBQUd6SCwyREFBNEU7QUFHNUUsOERBQTJEO0FBQzNELG1FQUEyRDtBQUMzRCxxRUFBeUQ7QUFDekQsdURBQW1EO0FBQ25ELG1EQUErQztBQUMvQyxpREFBNkM7QUFpQ3RDLElBQU0sU0FBUyxHQUFmLE1BQU0sU0FBUztJQUVDLElBQUksQ0FBOEI7SUFHbEMsV0FBVyxDQUFjO0lBR3pCLFFBQVEsQ0FBWTtJQUdwQixPQUFPLENBQVc7SUFFckMsV0FBVyxDQUFhO0lBQ2QsS0FBSyxDQUFtQjtJQUN4QixLQUFLLENBQVM7SUFDZCxZQUFZLENBQWU7SUFDM0IsVUFBVSxDQUFhO0lBQ3ZCLGNBQWMsQ0FBZ0I7SUFDeEMsSUFBVyxhQUFhO1FBQ3BCLE9BQU8sSUFBSSxDQUFDLGNBQWMsQ0FBQztJQUMvQixDQUFDO0lBRUQsWUFBWSxPQUEwQjtRQUNsQyxJQUFJLENBQUMsS0FBSyxHQUFHLE9BQU8sQ0FBQyxTQUFTLENBQUM7UUFDL0IsSUFBSSxJQUFJLENBQUMsS0FBSyxDQUFDLFlBQVksQ0FBQyxTQUFTLEVBQUUsQ0FBQztZQUNwQyxJQUFJLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxnRkFBZ0YsQ0FBQyxDQUFDO1FBQ3hHLENBQUM7UUFDRCxJQUFJLENBQUMsS0FBSyxHQUFHLE9BQU8sQ0FBQyxJQUFJLElBQUksTUFBTSxDQUFDO1FBQ3BDLElBQUksQ0FBQyxjQUFjLEdBQUcsSUFBSSw0QkFBWSxDQUFDLE9BQU8sQ0FBQyxjQUFjLENBQUMsQ0FBQztRQUMvRCxJQUFJLE9BQU8sQ0FBQyxTQUFTLEVBQUUsQ0FBQztZQUNwQixJQUFJLENBQUMsVUFBVSxHQUFHLE9BQU8sQ0FBQyxTQUFTLENBQUM7UUFDeEMsQ0FBQztJQUNMLENBQUM7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

package/dist/server/plugin.on-get-request.d.ts

@@ -0,0 +1,3 @@
+import * as schema from '../common/schema';
+import { A2APlugin } from './plugin';
+export declare function onGetTaskRequest(this: A2APlugin, req: schema.GetTaskRequest, cb: (result?: schema.GetTaskResponse) => void): Promise<void>;

package/dist/server/plugin.on-get-request.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.onGetTaskRequest = onGetTaskRequest;
+const serverUtils_1 = require("./serverUtils");
+const a2a_error_1 = require("./types/a2a-error");
+async function onGetTaskRequest(req, cb) {
+    const { id: taskId } = req.params;
+    // Load both task and history
+    const data = await this._taskStore.load(taskId);
+    if (!data) {
+        cb((0, serverUtils_1.normalizeError)(a2a_error_1.A2AError.taskNotFound(taskId), taskId));
+        return;
+    }
+    // Return only the task object as per spec
+    cb((0, serverUtils_1.createSuccessResponse)(taskId, data.task));
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGx1Z2luLm9uLWdldC1yZXF1ZXN0LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3NlcnZlci9wbHVnaW4ub24tZ2V0LXJlcXVlc3QudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7QUFPQSw0Q0FjQztBQWxCRCwrQ0FBc0U7QUFDdEUsaURBQTZDO0FBR3RDLEtBQUssVUFBVSxnQkFBZ0IsQ0FFbEMsR0FBMEIsRUFDMUIsRUFBNkM7SUFFN0MsTUFBTSxFQUFFLEVBQUUsRUFBRSxNQUFNLEVBQUUsR0FBRyxHQUFHLENBQUMsTUFBTSxDQUFDO0lBQ2xDLDZCQUE2QjtJQUM3QixNQUFNLElBQUksR0FBRyxNQUFNLElBQUksQ0FBQyxVQUFVLENBQUMsSUFBSSxDQUFDLE1BQU0sQ0FBQyxDQUFDO0lBQ2hELElBQUksQ0FBQyxJQUFJLEVBQUUsQ0FBQztRQUNSLEVBQUUsQ0FBQyxJQUFBLDRCQUFjLEVBQUMsb0JBQVEsQ0FBQyxZQUFZLENBQUMsTUFBTSxDQUFDLEVBQUUsTUFBTSxDQUFDLENBQUMsQ0FBQztRQUMxRCxPQUFPO0lBQ1gsQ0FBQztJQUNELDBDQUEwQztJQUMxQyxFQUFFLENBQUMsSUFBQSxtQ0FBcUIsRUFBQyxNQUFNLEVBQUUsSUFBSSxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUM7QUFDakQsQ0FBQyJ9

package/dist/server/plugin.on-send-request.d.ts

@@ -0,0 +1,9 @@
+import * as schema from '../common/schema';
+import { A2APlugin } from './plugin';
+/**
+ * Handles the tasks/send request by processing the user message and setting up event handlers
+ *
+ * @param req - The request containing the task parameters
+ * @param cb - The callback to call with the response
+ */
+export declare function onSendRequest(this: A2APlugin, req: schema.SendTaskRequest, cb: (result?: schema.SendTaskResponse) => void): Promise<void>;

package/dist/server/plugin.on-send-request.js

@@ -0,0 +1,107 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.onSendRequest = onSendRequest;
+const serverUtils_1 = require("./serverUtils");
+/**
+ * Handles the tasks/send request by processing the user message and setting up event handlers
+ *
+ * @param req - The request containing the task parameters
+ * @param cb - The callback to call with the response
+ */
+async function onSendRequest(req, cb) {
+    const { id: taskId, message, sessionId, metadata } = req.params;
+    // Load or create task AND history
+    const currentData = await this._taskManager.loadOrCreateTaskAndHistory(taskId, message, sessionId, metadata);
+    const taskContext = this._taskManager.createTaskContext(currentData.task, message, currentData.history);
+    // Create operation context with references that can be updated
+    const operationContext = {
+        taskManager: this._taskManager,
+        taskStore: this._taskStore,
+        logger: this._logger,
+        taskId,
+        reqId: req.id || null,
+        contextRef: { current: taskContext },
+        dataRef: { current: currentData },
+    };
+    // Create the helper functions with operation context
+    const respond = createRespondFunction(operationContext, cb);
+    const accumulateArtifacts = createArtifactsFunction(operationContext, cb);
+    // Emit the event to process the task
+    this.emit('a2a:message', {
+        taskContext,
+        respond,
+        accumulateArtifacts,
+    });
+}
+async function updateTask(ctx, update) {
+    try {
+        // Apply the update to the task
+        const updatedData = await ctx.taskManager.applyUpdateToTaskAndHistory(ctx.dataRef.current, update);
+        // Save the updated task
+        await ctx.taskStore.save(updatedData);
+        // Update the task context reference
+        ctx.contextRef.current.task = updatedData.task;
+        // Return success result
+        return {
+            success: true,
+            data: updatedData,
+        };
+    }
+    catch (error) {
+        return handleUpdateError(ctx, error, ctx.dataRef.current);
+    }
+}
+async function handleUpdateError(ctx, error, currentData) {
+    // Convert error to failure state
+    const failedUpdate = ctx.taskManager.createFailedTaskState(`Handler failed: ${error instanceof Error ? error.message : String(error)}`);
+    // Apply failure state to task
+    const failedData = await ctx.taskManager.applyUpdateToTaskAndHistory(currentData, failedUpdate);
+    // Try to save the failed state
+    try {
+        await ctx.taskStore.save(failedData);
+    }
+    catch (saveError) {
+        ctx.logger.error(`Failed to save task ${ctx.taskId} after handler error:`, saveError);
+    }
+    // Return failure result with original error
+    return {
+        success: false,
+        error: new Error(`Handler failed: ${error instanceof Error ? error.message : String(error)}`),
+    };
+}
+function createRespondFunction(ctx, callback) {
+    return async (update) => {
+        ctx.logger.debug(`Responding to task ${ctx.taskId}`);
+        let responseValue;
+        if (typeof update === 'string') {
+            responseValue = ctx.taskManager.createCompletedTaskState(update);
+        }
+        else {
+            responseValue = update;
+        }
+        const result = await updateTask(ctx, responseValue);
+        // Update the current data reference with the latest version
+        if (result.success) {
+            ctx.dataRef.current = result.data;
+        }
+        if (!result.success) {
+            ctx.logger.error(`Failed to save task during response: ${result.error}`);
+            callback((0, serverUtils_1.normalizeError)(result.error, ctx.reqId, ctx.taskId));
+            return;
+        }
+        callback((0, serverUtils_1.createSuccessResponse)(ctx.taskId, ctx.dataRef.current.task));
+    };
+}
+function createArtifactsFunction(ctx, callback) {
+    return async (artifact) => {
+        const result = await updateTask(ctx, artifact);
+        if (result.success) {
+            ctx.dataRef.current = result.data;
+        }
+        else {
+            ctx.logger.error(`Failed to accumulate artifacts: ${result.error}`);
+            callback((0, serverUtils_1.normalizeError)(result.error, ctx.reqId, ctx.taskId));
+        }
+    };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicGx1Z2luLm9uLXNlbmQtcmVxdWVzdC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9zZXJ2ZXIvcGx1Z2luLm9uLXNlbmQtcmVxdWVzdC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOztBQWlDQSxzQ0EwQ0M7QUFwRUQsK0NBQXNFO0FBb0J0RTs7Ozs7R0FLRztBQUNJLEtBQUssVUFBVSxhQUFhLENBRWpDLEdBQTJCLEVBQzNCLEVBQThDO0lBRTlDLE1BQU0sRUFBRSxFQUFFLEVBQUUsTUFBTSxFQUFFLE9BQU8sRUFBRSxTQUFTLEVBQUUsUUFBUSxFQUFFLEdBQUcsR0FBRyxDQUFDLE1BQU0sQ0FBQztJQUVoRSxrQ0FBa0M7SUFDbEMsTUFBTSxXQUFXLEdBQUcsTUFBTSxJQUFJLENBQUMsWUFBWSxDQUFDLDBCQUEwQixDQUNwRSxNQUFNLEVBQ04sT0FBTyxFQUNQLFNBQVMsRUFDVCxRQUFRLENBQ1QsQ0FBQztJQUVGLE1BQU0sV0FBVyxHQUFHLElBQUksQ0FBQyxZQUFZLENBQUMsaUJBQWlCLENBQ3JELFdBQVcsQ0FBQyxJQUFJLEVBQ2hCLE9BQU8sRUFDUCxXQUFXLENBQUMsT0FBTyxDQUNwQixDQUFDO0lBRUYsK0RBQStEO0lBQy9ELE1BQU0sZ0JBQWdCLEdBQTBCO1FBQzlDLFdBQVcsRUFBRSxJQUFJLENBQUMsWUFBWTtRQUM5QixTQUFTLEVBQUUsSUFBSSxDQUFDLFVBQVU7UUFDMUIsTUFBTSxFQUFFLElBQUksQ0FBQyxPQUFPO1FBQ3BCLE1BQU07UUFDTixLQUFLLEVBQUUsR0FBRyxDQUFDLEVBQUUsSUFBSSxJQUFJO1FBQ3JCLFVBQVUsRUFBRSxFQUFFLE9BQU8sRUFBRSxXQUFXLEVBQUU7UUFDcEMsT0FBTyxFQUFFLEVBQUUsT0FBTyxFQUFFLFdBQVcsRUFBRTtLQUNsQyxDQUFDO0lBRUYscURBQXFEO0lBQ3JELE1BQU0sT0FBTyxHQUFHLHFCQUFxQixDQUFDLGdCQUFnQixFQUFFLEVBQUUsQ0FBQyxDQUFDO0lBQzVE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

package/dist/server/serverUtils.d.ts

@@ -0,0 +1,13 @@
+import { Response } from 'express';
+import * as schema from '../common/schema';
+/**
+ * Validates if the reqest is of the expected type.
+ * If not, it sends a 400 response with an error message.
+ */
+export declare const validateRequest: <T extends schema.A2ARequest["method"]>(type: T, req: schema.A2ARequest, res: Response) => req is Extract<schema.A2ARequest, {
+    method: T;
+}>;
+export declare const createSuccessResponse: <T>(taskId: number | string | null, result: T) => schema.JSONRPCResponse<T, schema.A2AError>;
+export declare const createErrorResponse: (id: number | string | null | undefined, error: schema.JSONRPCError<unknown>) => schema.JSONRPCResponse<null, schema.A2AError>;
+/** Normalizes various error types into a JSONRPCResponse containing an error */
+export declare const normalizeError: (error: any, reqId: number | string | null | undefined, taskId?: string) => schema.JSONRPCResponse<null, schema.A2AError>;

package/dist/server/serverUtils.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeError = exports.createErrorResponse = exports.createSuccessResponse = exports.validateRequest = void 0;
+const a2a_error_1 = require("./types/a2a-error");
+const isType = (type) => (req) => {
+    return req.method === type;
+};
+/**
+ * Validates if the reqest is of the expected type.
+ * If not, it sends a 400 response with an error message.
+ */
+const validateRequest = (type, req, res) => {
+    if (isType(type)(req)) {
+        return true;
+    }
+    res
+        .status(400)
+        .send(a2a_error_1.A2AError.invalidRequest('Invalid JSON-RPC request structure').toJSONRPCError());
+    return false;
+};
+exports.validateRequest = validateRequest;
+const createSuccessResponse = (taskId, result) => {
+    if (taskId === null) {
+        // This shouldn't happen for methods that expect a response, but safeguard
+        throw a2a_error_1.A2AError.internalError('Cannot create success response for null ID.');
+    }
+    return {
+        jsonrpc: '2.0',
+        id: taskId,
+        result: result,
+    };
+};
+exports.createSuccessResponse = createSuccessResponse;
+const createErrorResponse = (id, error) => {
+    // For errors, ID should be the same as request ID, or null if that couldn't be determined
+    return {
+        jsonrpc: '2.0',
+        id: id, // Can be null if request ID was invalid/missing
+        error: error,
+    };
+};
+exports.createErrorResponse = createErrorResponse;
+/** Normalizes various error types into a JSONRPCResponse containing an error */
+const normalizeError = (error, reqId, taskId) => {
+    let a2aError;
+    if (error instanceof a2a_error_1.A2AError) {
+        a2aError = error;
+    }
+    else if (error instanceof Error) {
+        // Generic JS error
+        a2aError = a2a_error_1.A2AError.internalError(error.message, { stack: error.stack });
+    }
+    else {
+        // Unknown error type
+        a2aError = a2a_error_1.A2AError.internalError('An unknown error occurred.', error);
+    }
+    // Ensure Task ID context is present if possible
+    if (taskId && !a2aError.taskId) {
+        a2aError.taskId = taskId;
+    }
+    console.error(`Error processing request (Task: ${a2aError.taskId ?? 'N/A'}, ReqID: ${reqId ?? 'N/A'}):`, a2aError);
+    return (0, exports.createErrorResponse)(reqId, a2aError.toJSONRPCError());
+};
+exports.normalizeError = normalizeError;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2VydmVyVXRpbHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvc2VydmVyL3NlcnZlclV0aWxzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7OztBQUlBLGlEQUE2QztBQUU3QyxNQUFNLE1BQU0sR0FDVixDQUF3QyxJQUFPLEVBQUUsRUFBRSxDQUNqRCxDQUNFLEdBQXNCLEVBQzRCLEVBQUU7SUFDcEQsT0FBTyxHQUFHLENBQUMsTUFBTSxLQUFLLElBQUksQ0FBQztBQUM3QixDQUFDLENBQUM7QUFFTjs7O0dBR0c7QUFDSSxNQUFNLGVBQWUsR0FBRyxDQUM3QixJQUFPLEVBQ1AsR0FBc0IsRUFDdEIsR0FBYSxFQUNxQyxFQUFFO0lBQ3BELElBQUksTUFBTSxDQUFDLElBQUksQ0FBQyxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUM7UUFDdEIsT0FBTyxJQUFJLENBQUM7SUFDZCxDQUFDO0lBRUQsR0FBRztTQUNBLE1BQU0sQ0FBQyxHQUFHLENBQUM7U0FDWCxJQUFJLENBQ0gsb0JBQVEsQ0FBQyxjQUFjLENBQ3JCLG9DQUFvQyxDQUNyQyxDQUFDLGNBQWMsRUFBRSxDQUNuQixDQUFDO0lBQ0osT0FBTyxLQUFLLENBQUM7QUFDZixDQUFDLENBQUM7QUFqQlcsUUFBQSxlQUFlLG1CQWlCMUI7QUFFSyxNQUFNLHFCQUFxQixHQUFHLENBQ25DLE1BQThCLEVBQzlCLE1BQVMsRUFDbUMsRUFBRTtJQUM5QyxJQUFJLE1BQU0sS0FBSyxJQUFJLEVBQUUsQ0FBQztRQUNwQiwwRUFBMEU7UUFDMUUsTUFBTSxvQkFBUSxDQUFDLGFBQWEsQ0FBQyw2Q0FBNkMsQ0FBQyxDQUFDO0lBQzlFLENBQUM7SUFDRCxPQUFPO1FBQ0wsT0FBTyxFQUFFLEtBQUs7UUFDZCxFQUFFLEVBQUUsTUFBTTtRQUNWLE1BQU0sRUFBRSxNQUFNO0tBQ2YsQ0FBQztBQUNKLENBQUMsQ0FBQztBQWJXLFFBQUEscUJBQXFCLHlCQWFoQztBQUVLLE1BQU0sbUJBQW1CLEdBQUcsQ0FDakMsRUFBc0MsRUFDdEMsS0FBbUMsRUFDWSxFQUFFO0lBQ2pELDBGQUEwRjtJQUMxRixPQUFPO1FBQ0wsT0FBTyxFQUFFLEtBQUs7UUFDZCxFQUFFLEVBQUUsRUFBRSxFQUFFLGdEQUFnRDtRQUN4RCxLQUFLLEVBQUUsS0FBSztLQUNiLENBQUM7QUFDSixDQUFDLENBQUM7QUFWVyxRQUFBLG1CQUFtQix1QkFVOUI7QUFFRixnRkFBZ0Y7QUFDekUsTUFBTSxjQUFjLEdBQUcsQ0FDNUIsS0FBVSxFQUNWLEtBQXlDLEVBQ3pDLE1BQWUsRUFDZ0MsRUFBRTtJQUNqRCxJQUFJLFFBQWtCLENBQUM7SUFDdkIsSUFBSSxLQUFLLFlBQVksb0JBQVEsRUFBRSxDQUFDO1FBQzlCLFFBQVEsR0FBRyxLQUFLLENBQUM7SUFDbkIsQ0FBQztTQUFNLElBQUksS0FBSyxZQUFZLEtBQUssRUFBRSxDQUFDO1FBQ2xDLG1CQUFtQjtRQUNuQixRQUFRLEdBQUcsb0JBQVEsQ0FBQyxhQUFhLENBQUMsS0FBSyxDQUFDLE9BQU8sRUFBRSxFQUFFLEtBQUssRUFBRSxLQUFLLENBQUMsS0FBSyxFQUFFLENBQUMsQ0FBQztJQUMzRSxDQUFDO1NBQU0sQ0FBQztRQUNOLHFCQUFxQjtRQUNyQixRQUFRLEdBQUcsb0JBQVEsQ0FBQyxhQUFhLENBQUMsNEJBQTRCLEVBQUUsS0FBSyxDQUFDLENBQUM7SUFDekUsQ0FBQztJQUVELGdEQUFnRDtJQUNoRCxJQUFJLE1BQU0sSUFBSSxDQUFDLFFBQVEsQ0FBQyxNQUFNLEVBQUUsQ0FBQztRQUMvQixRQUFRLENBQUMsTUFBTSxHQUFHLE1BQU0sQ0FBQztJQUMzQixDQUFDO0lBRUQsT0FBTyxDQUFDLEtBQUssQ0FDWCxtQ0FBbUMsUUFBUSxDQUFDLE1BQU0sSUFBSSxLQUFLLFlBQVksS0FBSyxJQUFJLEtBQ2hGLElBQUksRUFDSixRQUFRLENBQ1QsQ0FBQztJQUVGLE9BQU8sSUFBQSwyQkFBbUIsRUFBQyxLQUFLLEVBQUUsUUFBUSxDQUFDLGNBQWMsRUFBRSxDQUFDLENBQUM7QUFDL0QsQ0FBQyxDQUFDO0FBNUJXLFFBQUEsY0FBYyxrQkE0QnpCIn0=

package/dist/server/tasks/task-manager.d.ts

@@ -0,0 +1,22 @@
+import { ILogger } from '@microsoft/teams.common';
+import * as schema from '../../common/schema';
+import { ITaskStore, TaskAndHistory, TaskContext, TaskUpdate } from '../types/a2a-types';
+export declare const finalStates: schema.TaskState[];
+export declare class TaskManager {
+    private taskStore;
+    private logger;
+    constructor(taskStore: ITaskStore, logger: ILogger);
+    applyUpdateToTaskAndHistory(current: TaskAndHistory, update: TaskUpdate): TaskAndHistory;
+    stateChangeOnNewRequest(currentState: schema.TaskState): schema.TaskState | null;
+    loadOrCreateTaskAndHistory(taskId: string, initialMessage: schema.Message, sessionId?: string | null, // Allow null
+    metadata?: Record<string, unknown> | null): Promise<TaskAndHistory>;
+    createTaskContext(task: schema.Task, userMessage: schema.Message, history: schema.Message[]): TaskContext;
+    isFinalState(current: TaskAndHistory): boolean;
+    createFailedTaskState(failureText: string): TaskUpdate;
+    createCompletedTaskState(text?: string): TaskUpdate;
+    createTaskStatusEvent(taskId: string, status: schema.TaskStatus, final: boolean): schema.TaskStatusUpdateEvent;
+    createTaskArtifactEvent(taskId: string, artifact: schema.Artifact, final: boolean): schema.TaskArtifactUpdateEvent;
+    private findArtifactIndex;
+    private appendToArtifact;
+    private sortArtifacts;
+}