@aramisfa/openclaw-a2a-outbound 0.1.2 → 0.2.0

package/dist/target-catalog.js

@@ -0,0 +1,309 @@
+import { A2AOutboundError, ERROR_CODES, toToolError, } from "./errors.js";
+function isNonEmptyString(value) {
+    return typeof value === "string" && value.trim() !== "";
+}
+function cloneSkillSummary(summary) {
+    return {
+        id: summary.id,
+        name: summary.name,
+        description: summary.description,
+        tags: [...summary.tags],
+        examples: [...summary.examples],
+    };
+}
+function cloneCardCacheEntry(entry) {
+    return {
+        ...(entry.displayName !== undefined
+            ? { displayName: entry.displayName }
+            : {}),
+        ...(entry.description !== undefined
+            ? { description: entry.description }
+            : {}),
+        skillSummaries: entry.skillSummaries.map(cloneSkillSummary),
+        ...(typeof entry.streamingSupported === "boolean"
+            ? { streamingSupported: entry.streamingSupported }
+            : {}),
+        ...(entry.preferredTransport !== undefined
+            ? { preferredTransport: entry.preferredTransport }
+            : {}),
+        ...(entry.lastRefreshedAt !== undefined
+            ? { lastRefreshedAt: entry.lastRefreshedAt }
+            : {}),
+        ...(entry.lastRefreshError !== undefined
+            ? { lastRefreshError: entry.lastRefreshError }
+            : {}),
+    };
+}
+function emptyCardCacheEntry() {
+    return {
+        skillSummaries: [],
+    };
+}
+function summarizeSkill(skill) {
+    return {
+        id: skill.id,
+        name: skill.name,
+        description: skill.description,
+        tags: [...skill.tags],
+        examples: [...(skill.examples ?? [])],
+    };
+}
+function fallbackErrorCode(error) {
+    return error instanceof A2AOutboundError
+        ? error.code
+        : ERROR_CODES.A2A_SDK_ERROR;
+}
+function targetResolutionError(reason, message, details) {
+    return new A2AOutboundError(ERROR_CODES.TARGET_RESOLUTION_ERROR, message, {
+        reason,
+        ...details,
+    });
+}
+export class TargetCatalog {
+    config;
+    clientPool;
+    configuredEntries;
+    targetsByAlias;
+    targetsByNormalizedBaseUrl;
+    defaultTargetAlias;
+    cardCache = new Map();
+    cardRefreshes = new Map();
+    constructor(options) {
+        this.config = options.config;
+        this.clientPool = options.clientPool;
+        const targetsByAlias = new Map();
+        const targetsByNormalizedBaseUrl = new Map();
+        let defaultTargetAlias;
+        const configuredEntries = this.config.targets.map((targetConfig) => {
+            const target = this.clientPool.normalizeTarget(targetConfig);
+            const entry = {
+                alias: targetConfig.alias,
+                ...(targetConfig.description !== undefined
+                    ? { configuredDescription: targetConfig.description }
+                    : {}),
+                default: targetConfig.default,
+                tags: Object.freeze([...targetConfig.tags]),
+                examples: Object.freeze([...targetConfig.examples]),
+                target: {
+                    ...target,
+                    alias: targetConfig.alias,
+                    ...(targetConfig.description !== undefined
+                        ? { description: targetConfig.description }
+                        : {}),
+                },
+            };
+            targetsByAlias.set(entry.alias, entry);
+            const existing = targetsByNormalizedBaseUrl.get(entry.target.baseUrl) ?? [];
+            targetsByNormalizedBaseUrl.set(entry.target.baseUrl, [...existing, entry]);
+            if (entry.default) {
+                defaultTargetAlias = entry.alias;
+            }
+            return entry;
+        });
+        this.configuredEntries = Object.freeze(configuredEntries);
+        this.targetsByAlias = targetsByAlias;
+        this.targetsByNormalizedBaseUrl = new Map([...targetsByNormalizedBaseUrl.entries()].map(([baseUrl, entries]) => [
+            baseUrl,
+            Object.freeze([...entries]),
+        ]));
+        this.defaultTargetAlias = defaultTargetAlias;
+    }
+    listEntries() {
+        return this.configuredEntries.map((entry) => this.toCatalogEntry(entry));
+    }
+    getEntry(alias) {
+        const normalizedAlias = alias.trim();
+        const entry = this.targetsByAlias.get(normalizedAlias);
+        return entry ? this.toCatalogEntry(entry) : undefined;
+    }
+    resolveAlias(alias) {
+        return this.resolveConfiguredEntry(this.requireAlias(alias));
+    }
+    resolveDefaultTarget() {
+        return this.defaultTargetAlias
+            ? this.resolveConfiguredEntry(this.requireAlias(this.defaultTargetAlias))
+            : undefined;
+    }
+    resolveConfiguredRawTarget(target) {
+        const normalizedTarget = this.clientPool.normalizeTarget(target);
+        const entry = this.findConfiguredEntry(normalizedTarget);
+        if (!entry) {
+            throw targetResolutionError("unknown_raw_url", `no configured target matches raw URL "${target.baseUrl}"`, {
+                inputBaseUrl: target.baseUrl,
+                normalizedBaseUrl: normalizedTarget.baseUrl,
+                suggested_action: "list_targets",
+            });
+        }
+        return this.resolveMatchedRawTarget(normalizedTarget, entry);
+    }
+    resolveRawTarget(target) {
+        const normalizedTarget = this.clientPool.normalizeTarget(target);
+        const entry = this.findConfiguredEntry(normalizedTarget);
+        if (entry) {
+            return this.resolveMatchedRawTarget(normalizedTarget, entry);
+        }
+        if (this.config.targets.length > 0 &&
+            this.config.policy.allowTargetUrlOverride !== true) {
+            throw targetResolutionError("raw_url_disallowed_by_policy", `raw target URL "${target.baseUrl}" is not allowed by policy`, {
+                inputBaseUrl: target.baseUrl,
+                normalizedBaseUrl: normalizedTarget.baseUrl,
+                allowTargetUrlOverride: this.config.policy.allowTargetUrlOverride,
+                configuredAliases: this.config.targets.map((entry) => entry.alias),
+                suggested_action: "list_targets",
+                hint: "Use target_alias or enable policy.allowTargetUrlOverride.",
+            });
+        }
+        return this.applyCachedMetadata(normalizedTarget);
+    }
+    async hydrateAllConfigured(options = {}) {
+        await Promise.allSettled(this.configuredEntries.map((entry) => this.loadCardMetadata(entry.target, options)));
+        return this.listEntries();
+    }
+    async hydrateConfiguredTarget(alias, options = {}) {
+        const entry = this.requireAlias(alias);
+        await this.loadCardMetadata(entry.target, options);
+        return this.toCatalogEntry(entry);
+    }
+    async hydrateResolvedTarget(target, options = {}) {
+        await this.loadCardMetadata(target, options);
+        return this.applyCachedMetadata(target);
+    }
+    requireAlias(alias) {
+        const normalizedAlias = alias.trim();
+        const entry = this.targetsByAlias.get(normalizedAlias);
+        if (!entry) {
+            throw targetResolutionError("unknown_alias", `unknown target alias "${normalizedAlias}"`, {
+                alias: normalizedAlias,
+                availableAliases: this.configuredEntries.map((item) => item.alias),
+                suggested_action: "list_targets",
+            });
+        }
+        return entry;
+    }
+    findConfiguredEntry(normalizedTarget) {
+        const matches = this.targetsByNormalizedBaseUrl.get(normalizedTarget.baseUrl) ?? [];
+        if (matches.length <= 1) {
+            return matches[0];
+        }
+        throw targetResolutionError("ambiguous_normalized_url_matches", `raw target URL "${normalizedTarget.baseUrl}" matches multiple configured targets`, {
+            normalizedBaseUrl: normalizedTarget.baseUrl,
+            aliases: matches.map((entry) => entry.alias),
+            suggested_action: "list_targets",
+            hint: "Disambiguate by using target_alias instead of target_url.",
+        });
+    }
+    resolveConfiguredEntry(entry) {
+        return this.applyCachedMetadata(entry.target);
+    }
+    resolveMatchedRawTarget(normalizedTarget, entry) {
+        return this.applyCachedMetadata({
+            ...normalizedTarget,
+            alias: entry.alias,
+            ...(entry.configuredDescription !== undefined
+                ? { description: entry.configuredDescription }
+                : {}),
+        });
+    }
+    toCatalogEntry(entry) {
+        return {
+            target: this.applyCachedMetadata(entry.target),
+            ...(entry.configuredDescription !== undefined
+                ? { configuredDescription: entry.configuredDescription }
+                : {}),
+            default: entry.default,
+            tags: [...entry.tags],
+            examples: [...entry.examples],
+            card: this.cardCacheSnapshot(entry.target.baseUrl),
+        };
+    }
+    cardCacheSnapshot(normalizedBaseUrl) {
+        const existing = this.cardCache.get(normalizedBaseUrl);
+        return cloneCardCacheEntry(existing ?? emptyCardCacheEntry());
+    }
+    applyCachedMetadata(target) {
+        const cached = this.cardCache.get(target.baseUrl);
+        const displayName = target.displayName ?? cached?.displayName;
+        const description = target.description ?? cached?.description;
+        const streamingSupported = target.streamingSupported ?? cached?.streamingSupported;
+        return {
+            baseUrl: target.baseUrl,
+            cardPath: target.cardPath,
+            preferredTransports: [...target.preferredTransports],
+            ...(target.alias !== undefined ? { alias: target.alias } : {}),
+            ...(displayName !== undefined ? { displayName } : {}),
+            ...(description !== undefined ? { description } : {}),
+            ...(streamingSupported !== undefined ? { streamingSupported } : {}),
+        };
+    }
+    async loadCardMetadata(target, options) {
+        const existing = this.cardCache.get(target.baseUrl);
+        if (options.force !== true &&
+            (existing?.lastRefreshedAt !== undefined ||
+                existing?.lastRefreshError !== undefined)) {
+            return cloneCardCacheEntry(existing);
+        }
+        const inFlight = this.cardRefreshes.get(target.baseUrl);
+        if (inFlight) {
+            return cloneCardCacheEntry(await inFlight);
+        }
+        const refreshPromise = this.refreshCardMetadata(target);
+        this.cardRefreshes.set(target.baseUrl, refreshPromise);
+        try {
+            return cloneCardCacheEntry(await refreshPromise);
+        }
+        finally {
+            if (this.cardRefreshes.get(target.baseUrl) === refreshPromise) {
+                this.cardRefreshes.delete(target.baseUrl);
+            }
+        }
+    }
+    async refreshCardMetadata(target) {
+        const refreshedAt = new Date().toISOString();
+        const previous = this.cardCache.get(target.baseUrl);
+        try {
+            const clientEntry = await this.clientPool.get(target);
+            const card = await clientEntry.client.getAgentCard();
+            const next = {
+                ...(isNonEmptyString(card.name) ? { displayName: card.name } : {}),
+                ...(isNonEmptyString(card.description)
+                    ? { description: card.description }
+                    : {}),
+                skillSummaries: card.skills.map(summarizeSkill),
+                ...(typeof card.capabilities?.streaming === "boolean"
+                    ? { streamingSupported: card.capabilities.streaming }
+                    : {}),
+                ...(isNonEmptyString(card.preferredTransport)
+                    ? { preferredTransport: card.preferredTransport }
+                    : {}),
+                lastRefreshedAt: refreshedAt,
+            };
+            this.cardCache.set(target.baseUrl, next);
+            return next;
+        }
+        catch (error) {
+            const next = {
+                ...(previous?.displayName !== undefined
+                    ? { displayName: previous.displayName }
+                    : {}),
+                ...(previous?.description !== undefined
+                    ? { description: previous.description }
+                    : {}),
+                skillSummaries: previous?.skillSummaries.map(cloneSkillSummary) ?? [],
+                ...(typeof previous?.streamingSupported === "boolean"
+                    ? { streamingSupported: previous.streamingSupported }
+                    : {}),
+                ...(previous?.preferredTransport !== undefined
+                    ? { preferredTransport: previous.preferredTransport }
+                    : {}),
+                lastRefreshedAt: refreshedAt,
+                lastRefreshError: toToolError(error, fallbackErrorCode(error)),
+            };
+            this.cardCache.set(target.baseUrl, next);
+            return next;
+        }
+    }
+}
+export function createTargetCatalog(options) {
+    return new TargetCatalog(options);
+}
+//# sourceMappingURL=target-catalog.js.map

package/dist/target-catalog.js.map

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

package/dist/task-handle-registry.d.ts

@@ -0,0 +1,29 @@
+import type { ResolvedTarget } from "./sdk-client-pool.js";
+export interface TaskHandleRecord {
+    taskHandle: string;
+    target: ResolvedTarget;
+    taskId: string;
+    createdAt: number;
+    lastAccessedAt: number;
+    expiresAt: number;
+}
+export interface TaskHandleRegistryOptions {
+    ttlMs: number;
+    maxEntries: number;
+    now?: () => number;
+}
+export declare class TaskHandleRegistry {
+    private readonly ttlMs;
+    private readonly maxEntries;
+    private readonly now;
+    private readonly entries;
+    constructor(options: TaskHandleRegistryOptions);
+    create(input: Pick<TaskHandleRecord, "target" | "taskId">): TaskHandleRecord;
+    resolve(taskHandle: string): TaskHandleRecord;
+    refresh(taskHandle: string, input?: Partial<Pick<TaskHandleRecord, "target" | "taskId">>): TaskHandleRecord;
+    private requireLiveEntry;
+    private pruneExpired;
+    private evictLeastRecentlyUsed;
+}
+export declare function createTaskHandleRegistry(options: TaskHandleRegistryOptions): TaskHandleRegistry;
+//# sourceMappingURL=task-handle-registry.d.ts.map

package/dist/task-handle-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-handle-registry.d.ts","sourceRoot":"","sources":["../src/task-handle-registry.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,yBAAyB;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAqED,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAE/B,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IAEpC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAe;IAEnC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAuC;gBAEnD,OAAO,EAAE,yBAAyB;IAM9C,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,QAAQ,CAAC,GAAG,gBAAgB;IAmB5E,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB;IAa7C,OAAO,CACL,UAAU,EAAE,MAAM,EAClB,KAAK,GAAE,OAAO,CAAC,IAAI,CAAC,gBAAgB,EAAE,QAAQ,GAAG,QAAQ,CAAC,CAAM,GAC/D,gBAAgB;IAkBnB,OAAO,CAAC,gBAAgB;IAqBxB,OAAO,CAAC,YAAY;IAQpB,OAAO,CAAC,sBAAsB;CAmB/B;AAED,wBAAgB,wBAAwB,CACtC,OAAO,EAAE,yBAAyB,GACjC,kBAAkB,CAEpB"}

package/dist/task-handle-registry.js

@@ -0,0 +1,141 @@
+import { randomUUID } from "node:crypto";
+import { A2AOutboundError, ERROR_CODES, } from "./errors.js";
+function cloneTarget(target) {
+    return {
+        baseUrl: target.baseUrl,
+        cardPath: target.cardPath,
+        preferredTransports: [...target.preferredTransports],
+        ...(target.alias !== undefined ? { alias: target.alias } : {}),
+        ...(target.displayName !== undefined
+            ? { displayName: target.displayName }
+            : {}),
+        ...(target.description !== undefined
+            ? { description: target.description }
+            : {}),
+        ...(target.streamingSupported !== undefined
+            ? { streamingSupported: target.streamingSupported }
+            : {}),
+    };
+}
+function cloneRecord(record) {
+    return {
+        taskHandle: record.taskHandle,
+        target: cloneTarget(record.target),
+        taskId: record.taskId,
+        createdAt: record.createdAt,
+        lastAccessedAt: record.lastAccessedAt,
+        expiresAt: record.expiresAt,
+    };
+}
+function recoveryDetails(taskHandle, details = {}) {
+    return {
+        taskHandle,
+        retryHint: "Retry with explicit target plus taskId, or resend the original request after a restart to obtain a new handle.",
+        restartInvalidatesHandles: true,
+        ...details,
+    };
+}
+function unknownTaskHandleError(taskHandle) {
+    return new A2AOutboundError(ERROR_CODES.UNKNOWN_TASK_HANDLE, `unknown task handle "${taskHandle}"`, recoveryDetails(taskHandle, {
+        suggested_action: "send",
+    }));
+}
+function expiredTaskHandleError(taskHandle, expiresAt) {
+    return new A2AOutboundError(ERROR_CODES.EXPIRED_TASK_HANDLE, `task handle "${taskHandle}" has expired`, recoveryDetails(taskHandle, {
+        expiresAt,
+        suggested_actions: ["status", "send"],
+        hint: "Retry with target_alias + task_id, or send a new request.",
+    }));
+}
+export class TaskHandleRegistry {
+    ttlMs;
+    maxEntries;
+    now;
+    entries = new Map();
+    constructor(options) {
+        this.ttlMs = options.ttlMs;
+        this.maxEntries = options.maxEntries;
+        this.now = options.now ?? Date.now;
+    }
+    create(input) {
+        const now = this.now();
+        this.pruneExpired(now);
+        const record = {
+            taskHandle: `rah_${randomUUID()}`,
+            target: cloneTarget(input.target),
+            taskId: input.taskId,
+            createdAt: now,
+            lastAccessedAt: now,
+            expiresAt: now + this.ttlMs,
+        };
+        this.entries.set(record.taskHandle, record);
+        this.evictLeastRecentlyUsed();
+        return cloneRecord(record);
+    }
+    resolve(taskHandle) {
+        const now = this.now();
+        const entry = this.requireLiveEntry(taskHandle, now);
+        const next = {
+            ...entry,
+            target: cloneTarget(entry.target),
+            lastAccessedAt: now,
+        };
+        this.entries.set(taskHandle, next);
+        return cloneRecord(next);
+    }
+    refresh(taskHandle, input = {}) {
+        const now = this.now();
+        const entry = this.requireLiveEntry(taskHandle, now);
+        const next = {
+            taskHandle: entry.taskHandle,
+            target: cloneTarget(input.target ?? entry.target),
+            taskId: input.taskId ?? entry.taskId,
+            createdAt: entry.createdAt,
+            lastAccessedAt: now,
+            expiresAt: now + this.ttlMs,
+        };
+        this.entries.set(taskHandle, next);
+        this.evictLeastRecentlyUsed();
+        return cloneRecord(next);
+    }
+    requireLiveEntry(taskHandle, now) {
+        const existing = this.entries.get(taskHandle);
+        const wasExpired = existing !== undefined && existing.expiresAt <= now;
+        this.pruneExpired(now);
+        if (wasExpired && existing) {
+            throw expiredTaskHandleError(taskHandle, existing.expiresAt);
+        }
+        const live = this.entries.get(taskHandle);
+        if (!live) {
+            throw unknownTaskHandleError(taskHandle);
+        }
+        return live;
+    }
+    pruneExpired(now) {
+        for (const [taskHandle, entry] of this.entries) {
+            if (entry.expiresAt <= now) {
+                this.entries.delete(taskHandle);
+            }
+        }
+    }
+    evictLeastRecentlyUsed() {
+        while (this.entries.size > this.maxEntries) {
+            let evictTaskHandle;
+            let oldestAccess = Number.POSITIVE_INFINITY;
+            for (const [taskHandle, entry] of this.entries) {
+                if (entry.lastAccessedAt < oldestAccess) {
+                    oldestAccess = entry.lastAccessedAt;
+                    evictTaskHandle = taskHandle;
+                }
+            }
+            if (!evictTaskHandle) {
+                return;
+            }
+            this.entries.delete(evictTaskHandle);
+        }
+    }
+}
+export function createTaskHandleRegistry(options) {
+    return new TaskHandleRegistry(options);
+}
+//# sourceMappingURL=task-handle-registry.js.map

package/dist/task-handle-registry.js.map

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

package/openclaw.plugin.json

@@ -1,9 +1,10 @@
 {
-  "id": "a2a-outbound",
+  "id": "openclaw-a2a-outbound",
   "name": "External A2A Delegation",
   "version": "0.1.0",
   "entry": "./dist/index.js",
   "description": "Delegate requests to external A2A agents and manage delegated tasks.",
+  "skills": ["./skills"],
   "configSchema": {
     "type": "object",
     "additionalProperties": false,
@@ -37,6 +38,68 @@
           }
         }
       },
+      "targets": {
+        "type": "array",
+        "default": [],
+        "items": {
+          "type": "object",
+          "additionalProperties": false,
+          "required": ["alias", "baseUrl"],
+          "properties": {
+            "alias": {
+              "type": "string"
+            },
+            "baseUrl": {
+              "type": "string"
+            },
+            "description": {
+              "type": "string"
+            },
+            "tags": {
+              "type": "array",
+              "items": { "type": "string" },
+              "default": []
+            },
+            "cardPath": {
+              "type": "string",
+              "default": "/.well-known/agent-card.json"
+            },
+            "preferredTransports": {
+              "type": "array",
+              "items": {
+                "type": "string",
+                "enum": ["JSONRPC", "HTTP+JSON", "GRPC"]
+              },
+              "default": ["JSONRPC", "HTTP+JSON"]
+            },
+            "examples": {
+              "type": "array",
+              "items": { "type": "string" },
+              "default": []
+            },
+            "default": {
+              "type": "boolean",
+              "default": false
+            }
+          }
+        }
+      },
+      "taskHandles": {
+        "type": "object",
+        "additionalProperties": false,
+        "properties": {
+          "ttlMs": {
+            "type": "integer",
+            "minimum": 1,
+            "default": 86400000
+          },
+          "maxEntries": {
+            "type": "integer",
+            "minimum": 1,
+            "default": 1000
+          }
+        }
+      },
       "policy": {
         "type": "object",
         "additionalProperties": false,
@@ -53,6 +116,10 @@
           "enforceSupportedTransports": {
             "type": "boolean",
             "default": true
+          },
+          "allowTargetUrlOverride": {
+            "type": "boolean",
+            "default": false
           }
         }
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aramisfa/openclaw-a2a-outbound",
-  "version": "0.1.2",
+  "version": "0.2.0",
   "description": "Outbound A2A delegation plugin for OpenClaw agents",
   "license": "MIT",
   "repository": {
@@ -31,6 +31,7 @@
   },
   "files": [
     "dist",
+    "skills",
     "openclaw.plugin.json",
     "README.md",
     "LICENSE"