@a2anet/a2a-utils 0.1.0 → 0.3.0

package/dist/types.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Typed interfaces for LLM-facing A2A responses.
+ */
+import type { AgentCard, TaskState } from "@a2a-js/sdk";
+export interface AgentURLAndCustomHeaders {
+    readonly agentCard: AgentCard;
+    readonly customHeaders: Record<string, string>;
+}
+export declare const TERMINAL_OR_ACTIONABLE_STATES: ReadonlySet<string>;
+/** Configuration for artifact minimization and viewing. */
+export declare class ArtifactSettings {
+    readonly sendMessageCharacterLimit: number;
+    readonly minimizedObjectStringLength: number;
+    readonly viewArtifactCharacterLimit: number;
+    constructor(opts?: {
+        sendMessageCharacterLimit?: number;
+        minimizedObjectStringLength?: number;
+        viewArtifactCharacterLimit?: number;
+    });
+}
+export interface TextPartForLLM {
+    readonly kind: "text";
+    readonly text: string;
+    readonly _total_lines?: number;
+    readonly _total_characters?: number;
+    readonly _start_line_range?: string;
+    readonly _end_line_range?: string;
+    readonly _start_character_range?: string;
+    readonly _end_character_range?: string;
+    readonly _tip?: string;
+}
+export interface DataPartForLLM {
+    readonly kind: "data";
+    readonly data: unknown;
+}
+export interface FilePartForLLM {
+    readonly kind: "file";
+    readonly name: string | null;
+    readonly mimeType: string | null;
+    readonly uri: string | Record<string, unknown> | null;
+    readonly bytes: Record<string, unknown> | null;
+}
+export interface ArtifactForLLM {
+    readonly artifactId: string;
+    readonly description: string | null;
+    readonly name: string | null;
+    readonly parts: ReadonlyArray<TextPartForLLM | DataPartForLLM | FilePartForLLM>;
+}
+export interface MessageForLLM {
+    readonly contextId: string | null;
+    readonly kind: "message";
+    readonly parts: ReadonlyArray<TextPartForLLM | DataPartForLLM | FilePartForLLM>;
+}
+export interface TaskStatusForLLM {
+    readonly state: TaskState;
+    readonly message: MessageForLLM | null;
+}
+export interface TaskForLLM {
+    readonly id: string;
+    readonly contextId: string;
+    readonly kind: "task";
+    readonly status: TaskStatusForLLM;
+    readonly artifacts: ReadonlyArray<ArtifactForLLM>;
+}
+//# 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,23 @@
+// SPDX-FileCopyrightText: 2025-present A2A Net <hello@a2anet.com>
+//
+// SPDX-License-Identifier: Apache-2.0
+export const TERMINAL_OR_ACTIONABLE_STATES = new Set([
+    "completed",
+    "canceled",
+    "failed",
+    "rejected",
+    "input-required",
+    "auth-required",
+]);
+/** Configuration for artifact minimization and viewing. */
+export class ArtifactSettings {
+    sendMessageCharacterLimit;
+    minimizedObjectStringLength;
+    viewArtifactCharacterLimit;
+    constructor(opts) {
+        this.sendMessageCharacterLimit = opts?.sendMessageCharacterLimit ?? 50_000;
+        this.minimizedObjectStringLength = opts?.minimizedObjectStringLength ?? 5_000;
+        this.viewArtifactCharacterLimit = opts?.viewArtifactCharacterLimit ?? 50_000;
+    }
+}
+//# 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,kEAAkE;AAClE,EAAE;AACF,sCAAsC;AAatC,MAAM,CAAC,MAAM,6BAA6B,GAAwB,IAAI,GAAG,CAAS;IAC9E,WAAW;IACX,UAAU;IACV,QAAQ;IACR,UAAU;IACV,gBAAgB;IAChB,eAAe;CAClB,CAAC,CAAC;AAEH,2DAA2D;AAC3D,MAAM,OAAO,gBAAgB;IAChB,yBAAyB,CAAS;IAClC,2BAA2B,CAAS;IACpC,0BAA0B,CAAS;IAE5C,YAAY,IAIX;QACG,IAAI,CAAC,yBAAyB,GAAG,IAAI,EAAE,yBAAyB,IAAI,MAAM,CAAC;QAC3E,IAAI,CAAC,2BAA2B,GAAG,IAAI,EAAE,2BAA2B,IAAI,KAAK,CAAC;QAC9E,IAAI,CAAC,0BAA0B,GAAG,IAAI,EAAE,0BAA0B,IAAI,MAAM,CAAC;IACjF,CAAC;CACJ"}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@a2anet/a2a-utils",
-    "version": "0.1.0",
+    "version": "0.3.0",
     "description": "A collection of utilities for discovering, communicating, and authenticating with A2A Servers",
     "type": "module",
     "exports": {
@@ -11,7 +11,9 @@
     },
     "main": "./dist/index.js",
     "types": "./dist/index.d.ts",
-    "files": ["dist"],
+    "files": [
+        "dist"
+    ],
     "scripts": {
         "build": "tsc",
         "check": "biome check .",
@@ -20,7 +22,11 @@
         "test": "bun test",
         "test:coverage": "bun test --coverage"
     },
-    "keywords": ["a2a", "agent-to-agent", "utilities"],
+    "keywords": [
+        "a2a",
+        "agent-to-agent",
+        "utilities"
+    ],
     "author": "A2A Net <hello@a2anet.com>",
     "license": "Apache-2.0",
     "repository": {
@@ -31,10 +37,17 @@
         "url": "https://github.com/a2anet/a2a-utils/issues"
     },
     "homepage": "https://github.com/a2anet/a2a-utils#readme",
+    "dependencies": {
+        "@a2a-js/sdk": "^0.3.10",
+        "uuid": "^11.1.0"
+    },
     "devDependencies": {
         "@biomejs/biome": "^1.9.0",
         "@types/bun": "latest",
+        "@types/uuid": "^10.0.0",
         "typescript": "^5.7.0"
     },
-    "trustedDependencies": ["@biomejs/biome"]
+    "trustedDependencies": [
+        "@biomejs/biome"
+    ]
 }