@ryubyte/dsh-a2a 0.1.0

package/lib/types/protocol.d.ts

@@ -0,0 +1,330 @@
+/**
+ * A2A (Agent2Agent) Protocol v1.0 — TypeScript type definitions.
+ *
+ * These types mirror the normative source of truth `specification/a2a.proto`
+ * (package `lf.a2a.v1`) from https://github.com/a2aproject/A2A, v1.0.0.
+ * JSON wire names are camelCase per ProtoJSON serialization; enum values use
+ * SCREAMING_SNAKE_CASE as mandated by A2A v1.0.
+ */
+/** The lifecycle states of a Task (a2a.proto `TaskState`). */
+export declare enum TaskState {
+    UNSPECIFIED = "TASK_STATE_UNSPECIFIED",
+    SUBMITTED = "TASK_STATE_SUBMITTED",
+    WORKING = "TASK_STATE_WORKING",
+    COMPLETED = "TASK_STATE_COMPLETED",
+    FAILED = "TASK_STATE_FAILED",
+    CANCELED = "TASK_STATE_CANCELED",
+    INPUT_REQUIRED = "TASK_STATE_INPUT_REQUIRED",
+    REJECTED = "TASK_STATE_REJECTED",
+    AUTH_REQUIRED = "TASK_STATE_AUTH_REQUIRED"
+}
+export type TerminalTaskState = TaskState.COMPLETED | TaskState.FAILED | TaskState.CANCELED | TaskState.REJECTED;
+export type InterruptedTaskState = TaskState.INPUT_REQUIRED | TaskState.AUTH_REQUIRED;
+export declare function isTerminal(state: TaskState): state is TerminalTaskState;
+/** The sender of a Message (a2a.proto `Role`). */
+export declare enum Role {
+    UNSPECIFIED = "ROLE_UNSPECIFIED",
+    USER = "ROLE_USER",
+    AGENT = "ROLE_AGENT"
+}
+/**
+ * A section of communication content (a2a.proto `Part`): exactly one of
+ * text / raw / url / data.
+ */
+export type Part = {
+    text: string;
+    raw?: never;
+    url?: never;
+    data?: never;
+    mediaType?: string;
+    filename?: string;
+    metadata?: Record<string, unknown>;
+} | {
+    raw: string;
+    text?: never;
+    url?: never;
+    data?: never;
+    mediaType?: string;
+    filename?: string;
+    metadata?: Record<string, unknown>;
+} | {
+    url: string;
+    text?: never;
+    raw?: never;
+    data?: never;
+    mediaType?: string;
+    filename?: string;
+    metadata?: Record<string, unknown>;
+} | {
+    data: unknown;
+    text?: never;
+    raw?: never;
+    url?: never;
+    mediaType?: string;
+    filename?: string;
+    metadata?: Record<string, unknown>;
+};
+/** One unit of communication between client and server (a2a.proto `Message`). */
+export interface Message {
+    messageId: string;
+    /** Required for server (ROLE_AGENT) messages. */
+    contextId?: string;
+    taskId?: string;
+    role: Role | string;
+    parts: Part[];
+    metadata?: Record<string, unknown>;
+    extensions?: string[];
+    referenceTaskIds?: string[];
+}
+/** Task output (a2a.proto `Artifact`). */
+export interface Artifact {
+    artifactId: string;
+    name?: string;
+    parts: Part[];
+    metadata?: Record<string, unknown>;
+    /** Only present in task-artifact-update events. */
+    append?: boolean;
+    lastChunk?: boolean;
+}
+/** Status of a task (a2a.proto `TaskStatus`). */
+export interface TaskStatus {
+    state: TaskState | string;
+    message?: Message;
+    /** ISO 8601 timestamp. */
+    timestamp?: string;
+}
+/** The core unit of action for A2A (a2a.proto `Task`). */
+export interface Task {
+    id: string;
+    contextId?: string;
+    status: TaskStatus;
+    artifacts?: Artifact[];
+    history?: Message[];
+    metadata?: Record<string, unknown>;
+}
+/** Configuration for a send request (a2a.proto `SendMessageConfiguration`). */
+export interface SendMessageConfiguration {
+    acceptedOutputModes?: string[];
+    taskPushNotificationConfig?: TaskPushNotificationConfig;
+    historyLength?: number;
+    returnImmediately?: boolean;
+}
+/** Push notification registration (a2a.proto `TaskPushNotificationConfig`). */
+export interface TaskPushNotificationConfig {
+    tenant?: string;
+    id?: string;
+    taskId?: string;
+    url: string;
+    token?: string;
+    authentication?: AuthenticationInfo;
+}
+/** Authentication details for push (a2a.proto `AuthenticationInfo`). */
+export interface AuthenticationInfo {
+    scheme: string;
+    credentials?: string;
+}
+/** Discriminated stream payloads (a2a.proto `StreamResponse`). */
+export type StreamResponse = {
+    task: Task;
+    message?: never;
+    statusUpdate?: never;
+    artifactUpdate?: never;
+} | {
+    message: Message;
+    task?: never;
+    statusUpdate?: never;
+    artifactUpdate?: never;
+} | {
+    statusUpdate: TaskStatusUpdateEvent;
+    task?: never;
+    message?: never;
+    artifactUpdate?: never;
+} | {
+    artifactUpdate: TaskArtifactUpdateEvent;
+    task?: never;
+    message?: never;
+    statusUpdate?: never;
+};
+export interface TaskStatusUpdateEvent {
+    taskId: string;
+    contextId: string;
+    status: TaskStatus;
+    metadata?: Record<string, unknown>;
+}
+export interface TaskArtifactUpdateEvent {
+    taskId: string;
+    contextId: string;
+    artifact: Artifact;
+    append?: boolean;
+    lastChunk?: boolean;
+    metadata?: Record<string, unknown>;
+}
+/** Response payload of SendMessage (a2a.proto `SendMessageResponse`). */
+export type SendMessageResponse = {
+    task: Task;
+    message?: never;
+} | {
+    message: Message;
+    task?: never;
+};
+/** A declaration of a protocol extension (a2a.proto `AgentExtension`). */
+export interface AgentExtension {
+    uri: string;
+    description?: string;
+    required?: boolean;
+    params?: Record<string, unknown>;
+}
+/** Optional capabilities (a2a.proto `AgentCapabilities`). */
+export interface AgentCapabilities {
+    streaming?: boolean;
+    pushNotifications?: boolean;
+    extensions?: AgentExtension[];
+    extendedAgentCard?: boolean;
+}
+/** A distinct capability an agent can perform (a2a.proto `AgentSkill`). */
+export interface AgentSkill {
+    id: string;
+    name: string;
+    description: string;
+    tags?: string[];
+    examples?: string[];
+    inputModes?: string[];
+    outputModes?: string[];
+    securityRequirements?: SecurityRequirement[];
+}
+/** OAuth flows supported by an agent (v1.0: code, client-credentials, device-code). */
+export interface OAuthFlows {
+    authorizationCode?: AuthorizationCodeOAuthFlow;
+    clientCredentials?: ClientCredentialsOAuthFlow;
+    deviceCode?: DeviceCodeOAuthFlow;
+}
+export interface AuthorizationCodeOAuthFlow {
+    authorizationUrl: string;
+    tokenUrl: string;
+    scopes?: Record<string, string>;
+    refreshUrl?: string;
+    pkceRequired?: boolean;
+}
+export interface ClientCredentialsOAuthFlow {
+    tokenUrl: string;
+    scopes?: Record<string, string>;
+}
+export interface DeviceCodeOAuthFlow {
+    deviceAuthorizationUrl: string;
+    tokenUrl: string;
+    scopes?: Record<string, string>;
+}
+/** Security scheme (v1.0 supports apiKey, http, oauth2, openIdConnect, mutualTls). */
+export type SecurityScheme = {
+    type: 'apiKey';
+    name: string;
+    in: 'header' | 'query' | 'cookie';
+    description?: string;
+} | {
+    type: 'http';
+    scheme: 'basic' | 'bearer' | 'digest';
+    bearerFormat?: string;
+    description?: string;
+} | {
+    type: 'oauth2';
+    flows: OAuthFlows;
+    description?: string;
+} | {
+    type: 'openIdConnect';
+    openIdConnectUrl: string;
+    description?: string;
+} | {
+    type: 'mutualTls';
+    description?: string;
+};
+export interface SecurityRequirement {
+    /** Map of scheme name → required scopes. */
+    schemes: Record<string, string[]>;
+}
+/** The provider of an agent (a2a.proto `AgentProvider`). */
+export interface AgentProvider {
+    url: string;
+    organization: string;
+}
+/** JWS signature of an AgentCard (RFC 7515). */
+export interface AgentCardSignature {
+    protected: string;
+    signature: string;
+    header?: Record<string, unknown>;
+}
+/** A target URL + transport + protocol version (a2a.proto `AgentInterface`). */
+export interface AgentInterface {
+    url: string;
+    protocolBinding: 'JSONRPC' | 'GRPC' | 'HTTP+JSON' | string;
+    /** Opaque routing value; clients MUST echo it in requests when set. */
+    tenant?: string;
+    protocolVersion: string;
+}
+/** Self-describing agent manifest (a2a.proto `AgentCard`). */
+export interface AgentCard {
+    name: string;
+    description: string;
+    version: string;
+    supportedInterfaces: AgentInterface[];
+    provider?: AgentProvider;
+    documentationUrl?: string;
+    capabilities: AgentCapabilities;
+    securitySchemes?: Record<string, SecurityScheme>;
+    securityRequirements?: SecurityRequirement[];
+    defaultInputModes: string[];
+    defaultOutputModes: string[];
+    skills?: AgentSkill[];
+    signatures?: AgentCardSignature[];
+    iconUrl?: string;
+}
+/** JSON-RPC 2.0 request/response/error envelopes used by the JSONRPC binding. */
+export interface JsonRpcRequest {
+    jsonrpc: '2.0';
+    id: string | number | null;
+    method: string;
+    params?: unknown;
+}
+export interface JsonRpcSuccess {
+    jsonrpc: '2.0';
+    id: string | number | null;
+    result: unknown;
+}
+export interface JsonRpcError {
+    jsonrpc: '2.0';
+    id: string | number | null;
+    error: {
+        code: number;
+        message: string;
+        data?: unknown;
+    };
+}
+export type JsonRpcResponse = JsonRpcSuccess | JsonRpcError;
+/** A2A JSON-RPC method names (v1.0 canonical PascalCase as in a2a.proto RPCs). */
+export declare const A2A_METHODS: {
+    readonly sendMessage: "SendMessage";
+    readonly sendStreamingMessage: "SendStreamingMessage";
+    readonly getTask: "GetTask";
+    readonly listTasks: "ListTasks";
+    readonly cancelTask: "CancelTask";
+    readonly subscribeToTask: "SubscribeToTask";
+    readonly getExtendedAgentCard: "GetExtendedAgentCard";
+};
+/** Standard error codes from the A2A JSON-RPC binding. */
+export declare const A2A_ERROR_CODES: {
+    readonly INVALID_REQUEST: -32600;
+    readonly METHOD_NOT_FOUND: -32601;
+    readonly INVALID_PARAMS: -32602;
+    readonly INTERNAL_ERROR: -32603;
+    readonly TASK_NOT_FOUND: -32001;
+    readonly TASK_CANCEL_NOT_ALLOWED: -32002;
+    readonly TASK_ALREADY_CANCELED: -32003;
+    readonly AGENT_CARD_NOT_FOUND: -32004;
+    readonly AGENT_CARD_SIGNATURE_INVALID: -32005;
+    readonly CONTEXT_NOT_FOUND: -32006;
+    readonly AUTHENTICATION_REQUIRED: -32007;
+    readonly PUSH_NOTIFICATION_CONFIG_NOT_FOUND: -32008;
+    readonly EXTENSION_NOT_SUPPORTED: -32009;
+    readonly UNSUPPORTED_OPERATION: -32010;
+    readonly VERSION_NOT_SUPPORTED: -32011;
+};
+//# sourceMappingURL=protocol.d.ts.map

package/lib/types/protocol.d.ts.map

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

package/lib/types/server.d.ts

@@ -0,0 +1,142 @@
+/**
+ * dsh-a2a — inbound half: serve DSH as an A2A agent.
+ *
+ * Implements the server side of A2A v1.0 JSONRPC binding:
+ *   - `/.well-known/agent-card.json` agent manifest
+ *   - POST JSON-RPC endpoint handling SendMessage / GetTask / ListTasks /
+ *     CancelTask / SendStreamingMessage (SSE) / SubscribeToTask
+ *
+ * Task execution is delegated to an injectable executor so compositions can
+ * wire DSH's real agent loop; plugin ships a default executor that runs
+ * shell commands in the workspace.
+ */
+import type { AgentCard, AgentSkill, Message, Part, Task } from './protocol.js';
+import { TaskState } from './protocol.js';
+export interface ServerSkill extends AgentSkill {
+}
+export interface ServerOptions {
+    /** Public base URL (scheme + host + optional prefix) where this DSH is exposed. */
+    baseUrl: string;
+    agentName: string;
+    agentDescription: string;
+    agentVersion: string;
+    agentProvider?: {
+        url: string;
+        organization: string;
+    };
+    skills?: ServerSkill[];
+    /** Override the executor that runs an incoming task. */
+    execute?: TaskExecutor;
+    /** Extra custom headers on the AgentCard (rarely needed). */
+    iconUrl?: string;
+    defaultInputModes?: string[];
+    defaultOutputModes?: string[];
+    /** Where tasks are accepted — the JSON-RPC POST route path. */
+    endpointPath?: string;
+    /**
+     * Optional inbound observation hook: called for every JSON-RPC request with
+     * the request facts and the task ids it touched. Lets the connection
+     * dashboard track "who is talking to us".
+     */
+    onInbound?: (facts: InboundFacts) => void;
+    /** Called when a task reaches a terminal state (completed/failed/canceled). */
+    onTaskSettled?: (taskId: string) => void;
+}
+/** Observational facts about one inbound JSON-RPC request. */
+export interface InboundFacts {
+    method: string;
+    headers?: Record<string, string>;
+    source?: string;
+    taskIds: string[];
+    streaming: boolean;
+}
+export interface TaskExecutor {
+    (input: {
+        message: Message;
+        taskId: string;
+        contextId: string;
+        signal: AbortSignal;
+    }): Promise<Message>;
+}
+export interface InboundHandle {
+    card: AgentCard;
+    endpointPath: string;
+    taskStore: TaskStore;
+    dispose: () => void;
+}
+/** In-memory task store with the full A2A Task lifecycle. */
+export declare class TaskStore {
+    private tasks;
+    private messages;
+    create(message: Message): Task;
+    get(id: string): Task | undefined;
+    list(): Task[];
+    setStatus(taskId: string, state: TaskState, message?: Message): Task;
+    addArtifact(taskId: string, artifact: {
+        artifactId: string;
+        parts: Part[];
+        name?: string;
+        append?: boolean;
+        lastChunk?: boolean;
+    }): Task;
+    getMessage(id: string): Message | undefined;
+}
+/** A2A JSON-RPC server handler over a raw HTTP request/response pair. */
+export declare class A2AServer {
+    readonly options: ServerOptions;
+    readonly store: TaskStore;
+    readonly card: AgentCard;
+    readonly endpointPath: string;
+    private execute;
+    private listeners;
+    private baseUrl;
+    constructor(options: ServerOptions, store?: TaskStore);
+    /**
+     * Update the base URL advertised in the AgentCard after the real listen
+     * address is known (e.g. ephemeral port). Mutates `card` in place.
+     */
+    setBaseUrl(baseUrl: string): void;
+    private buildCard;
+    private emit;
+    /** Route an inbound HTTP request; returns true when handled. */
+    handle(req: {
+        method?: string;
+        url?: string;
+        headers?: {
+            'content-type'?: string;
+        };
+        socket?: {
+            remoteAddress?: string;
+            remotePort?: number;
+        };
+    }, body: string): Promise<{
+        status: number;
+        contentType: string;
+        body: string;
+    }>;
+    handleStream(req: {
+        method?: string;
+        url?: string;
+        headers?: Record<string, string>;
+        socket?: {
+            remoteAddress?: string;
+            remotePort?: number;
+        };
+    }, body: string, onEvent: (frame: string) => void): Promise<{
+        status: number;
+    }>;
+    private ensureTask;
+    private waitTerminal;
+    /** Execute a task in the background, streaming status/artifact updates. */
+    private runTask;
+    private dispatch;
+    private jsonRpcError;
+}
+export declare const defaultSkills: ServerSkill[];
+/**
+ * Default executor: run the incoming prompt through the system shell and
+ * return the captured stdout/stderr as the task artifact. Honors the
+ * AbortSignal (task cancellation / shutdown) by killing the child process.
+ */
+export declare const defaultExecutor: TaskExecutor;
+//# sourceMappingURL=server.d.ts.map

package/lib/types/server.d.ts.map

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

package/package.json

@@ -0,0 +1,89 @@
+{
+  "name": "@ryubyte/dsh-a2a",
+  "description": "Agent2Agent (A2A) protocol v1.0 plugin for DeepSeek Harness (DSH): outbound client (remote AgentCard skills as ctx.tools), inbound server (A2A JSON-RPC + AgentCard endpoint), and a settings dashboard of live A2A connections",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "lib/index.js",
+  "types": "lib/types/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/types/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./client": {
+      "types": "./lib/types/client/index.d.ts",
+      "default": "./lib/client.js"
+    },
+    "./types": {
+      "types": "./lib/types/protocol.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./src/*": "./src/*",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib/**/*.js",
+    "lib/**/*.js.map",
+    "lib/**/*.d.ts",
+    "lib/**/*.d.ts.map",
+    "src",
+    "cordis.patch.yml",
+    "README.md",
+    "README.zh-CN.md"
+  ],
+  "license": "MIT",
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && tsdown && node scripts/build-client.mjs",
+    "bundle": "tsdown && node scripts/build-client.mjs",
+    "typecheck": "tsc --noEmit",
+    "test": "npm run build && node --import tsx --test \"test/**/*.test.ts\" && node test/client-bundle-smoke.mjs",
+    "shots": "node scripts/capture-shots.mjs",
+    "prepublishOnly": "pnpm build"
+  },
+  "dependencies": {
+    "typescript": "^5.5.0"
+  },
+  "peerDependencies": {
+    "@deepseek-ai/cordis": "^4.0.1",
+    "@deepseek-ai/dsh-client-runtime": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-slots": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-client-ui-settings": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-host-webserver": "^0.1.0-rc.6",
+    "@deepseek-ai/dsh-tools": "^0.1.0-rc.6",
+    "react": "^19.2.0",
+    "react-dom": "^19.2.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/react": "^19.2.18",
+    "@types/react-dom": "^19.2.4",
+    "esbuild": "^0.28.2",
+    "react": "^19.2.8",
+    "react-dom": "^19.2.8",
+    "tsdown": "^0.22.14",
+    "tsx": "^4.19.0"
+  },
+  "dsh": {
+    "client": {
+      "inject": [
+        "@deepseek-ai/dsh-client-runtime",
+        "@deepseek-ai/dsh-client-ui-slots",
+        "@deepseek-ai/dsh-client-ui-settings"
+      ],
+      "platform": "web"
+    },
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ryubyte/dsh-a2a.git"
+  },
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}