@sekuire/sdk 0.1.8 → 0.1.10

package/dist/types/a2a-types.d.ts

@@ -0,0 +1,194 @@
+/**
+ * A2A Protocol Type Definitions
+ *
+ * Types implementing the A2A Protocol specification for agent interoperability.
+ * See: https://github.com/a2aproject/A2A
+ */
+/** Full A2A-compliant Agent Card */
+export interface AgentCard {
+    /** Unique agent identifier (e.g., "sekuire:workspace:agent-name") */
+    agentId: string;
+    /** Human-readable agent name */
+    name: string;
+    /** Agent description */
+    description: string;
+    /** Semantic version */
+    version: string;
+    /** Provider information */
+    provider?: AgentProvider;
+    /** Supported A2A protocol versions */
+    protocolVersions: string[];
+    /** Agent capabilities */
+    capabilities: AgentCapabilities;
+    /** Skills the agent provides */
+    skills: AgentSkill[];
+    /** Default input MIME types accepted */
+    defaultInputModes?: string[];
+    /** Default output MIME types produced */
+    defaultOutputModes?: string[];
+    /** Security schemes supported */
+    securitySchemes?: Record<string, SecurityScheme>;
+    /** Required security scheme names */
+    security?: string[];
+    /** Base URL for A2A endpoints */
+    url: string;
+}
+/** Provider information */
+export interface AgentProvider {
+    name: string;
+    url?: string;
+}
+/** Agent capabilities */
+export interface AgentCapabilities {
+    /** Supports streaming responses via SSE */
+    streaming: boolean;
+    /** Supports push notifications */
+    pushNotifications: boolean;
+    /** Supports extended agent card endpoint */
+    extendedAgentCard: boolean;
+}
+/** Security scheme definition */
+export interface SecurityScheme {
+    type: string;
+    scheme?: string;
+    bearerFormat?: string;
+}
+/** Structured skill definition */
+export interface AgentSkill {
+    /** Skill identifier (e.g., "document:summarize") */
+    id: string;
+    /** Human-readable skill name */
+    name: string;
+    /** Skill description */
+    description?: string;
+    /** Tags for categorization */
+    tags?: string[];
+    /** Input MIME types accepted */
+    inputModes?: string[];
+    /** Output MIME types produced */
+    outputModes?: string[];
+    /** Example prompts */
+    examples?: string[];
+}
+/** A2A message with role and parts */
+export interface A2AMessage {
+    /** Message role: "user" or "agent" */
+    role: "user" | "agent";
+    /** Message content parts */
+    parts: A2AMessagePart[];
+}
+/** Message part content */
+export type A2AMessagePart = {
+    type: "text";
+    text: string;
+} | {
+    type: "file";
+    uri: string;
+    mimeType?: string;
+} | {
+    type: "data";
+    data: unknown;
+};
+/** A2A task states */
+export type A2ATaskState = "pending" | "working" | "input-required" | "completed" | "failed" | "cancelled";
+/** A2A task status with timestamp */
+export interface A2ATaskStatus {
+    state: A2ATaskState;
+    timestamp: string;
+}
+/** Full A2A task */
+export interface A2ATask {
+    taskId: string;
+    contextId?: string;
+    status: A2ATaskStatus;
+    artifacts: A2AArtifact[];
+    history: A2AMessage[];
+    /** ID of the task that delegated to this task */
+    parentTaskId?: string;
+    /** Trace ID shared across the delegation chain */
+    traceId?: string;
+}
+/** Task artifact output */
+export interface A2AArtifact {
+    name?: string;
+    parts: A2AMessagePart[];
+    index?: number;
+}
+/** Request for skill-based auto-discovery routing */
+export interface A2ARouteRequest {
+    /** Required skill (e.g., "document:summarize") */
+    skill: string;
+    /** Message to send to the agent */
+    message: A2AMessage;
+    /** Optional conversation context ID */
+    contextId?: string;
+    /** Parent task ID for delegation tracking */
+    parentTaskId?: string;
+    /** Trace ID for the entire delegation chain */
+    traceId?: string;
+}
+/** Response from skill-based routing */
+export interface A2ARouteResponse {
+    /** Created task ID */
+    taskId: string;
+    /** Current task status */
+    status: A2ATaskState;
+    /** ID of the selected agent */
+    agentId: string;
+    /** Initial response message (if any) */
+    message?: A2AMessage;
+    /** Trace ID for the delegation chain */
+    traceId?: string;
+}
+/** JSON-RPC 2.0 Request */
+export interface JsonRpcRequest {
+    jsonrpc: "2.0";
+    method: string;
+    id: string | number;
+    params?: unknown;
+}
+/** JSON-RPC 2.0 Response */
+export interface JsonRpcResponse<T = unknown> {
+    jsonrpc: "2.0";
+    id: string | number;
+    result?: T;
+    error?: JsonRpcError;
+}
+/** JSON-RPC 2.0 Error */
+export interface JsonRpcError {
+    code: number;
+    message: string;
+    data?: unknown;
+}
+/** Parameters for tasks/send method */
+export interface TasksSendParams {
+    /** Optional existing task ID to continue */
+    taskId?: string;
+    /** Message to send */
+    message: A2AMessage;
+    /** Optional context ID for grouping tasks */
+    contextId?: string;
+}
+/** Parameters for tasks/get method */
+export interface TasksGetParams {
+    taskId: string;
+}
+/** Parameters for tasks/cancel method */
+export interface TasksCancelParams {
+    taskId: string;
+}
+/** Parameters for tasks/sendSubscribe method */
+export interface TasksSendSubscribeParams {
+    /** Optional existing task ID to continue */
+    taskId?: string;
+    /** Message to send */
+    message: A2AMessage;
+}
+/** SSE task update event */
+export interface TaskUpdateEvent {
+    taskId: string;
+    status: A2ATaskState;
+    updatedAt: string;
+    message?: A2AMessage;
+    artifacts?: A2AArtifact[];
+}

package/dist/types.d.ts

@@ -134,6 +134,7 @@ export interface WorkspaceSummary {
 }
 export interface SekuireClientConfig {
     registryUrl: string;
+    apiKey?: string;
     timeout?: number;
     retries?: number;
 }

package/dist/utils.d.ts

@@ -22,10 +22,6 @@ export declare function createSekuireClient(keyPair: KeyPair, registryUrl?: stri
  * Load keypair from environment variables
  */
 export declare function loadKeyPairFromEnv(): KeyPair;
-/**
- * Load keypair from files
- */
-export declare function loadKeyPairFromFiles(privateKeyPath: string, publicKeyPath?: string): Promise<KeyPair>;
 /**
  * Validate agent configuration
  */

package/dist/worker.d.ts

@@ -0,0 +1,104 @@
+/**
+ * Sekuire Task Worker
+ *
+ * Handles SSE connection to Core for real-time task delivery.
+ * Provides `onTask()` API for agents to register task handlers.
+ */
+export interface TaskEvent {
+    task_id: string;
+    capability?: string;
+    tool?: string;
+    input: Record<string, unknown>;
+    workspace_id: string;
+    requester_agent_id?: string;
+    parent_task_id?: string;
+    trace_id?: string;
+    workflow_id?: string;
+}
+export interface TaskContext {
+    taskId: string;
+    workspaceId: string;
+    requesterId?: string;
+    parentTaskId?: string;
+    traceId?: string;
+    workflowId?: string;
+}
+export type TaskHandler = (ctx: TaskContext, input: Record<string, unknown>) => Promise<unknown>;
+export interface WorkerConfig {
+    apiBaseUrl: string;
+    token: string;
+    agentId?: string;
+    apiKey?: string;
+    heartbeatIntervalMs?: number;
+    reconnectDelayMs?: number;
+    maxReconnectDelayMs?: number;
+    deploymentUrl?: string;
+}
+export declare class TaskWorker {
+    private eventSource;
+    private handlers;
+    private config;
+    private heartbeatInterval;
+    private reconnectDelay;
+    private isConnected;
+    private isPaused;
+    private installationId;
+    private onCommandCallback?;
+    constructor(config: WorkerConfig);
+    /**
+     * Register a handler for a specific capability
+     */
+    onTask(capability: string, handler: TaskHandler): this;
+    /**
+     * Start the worker (connects to SSE stream and starts heartbeat)
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the worker gracefully
+     */
+    stop(): Promise<void>;
+    /**
+     * Check if the worker is currently paused
+     */
+    getIsPaused(): boolean;
+    /**
+     * Register a callback for control commands
+     */
+    onCommand(callback: (cmd: {
+        type: string;
+        reason?: string;
+    }) => void): this;
+    /**
+     * Handle control commands from SSE or heartbeat fallback
+     */
+    private handleCommand;
+    /**
+     * Get API key from config or environment
+     */
+    private getApiKey;
+    /**
+     * Connect to SSE stream
+     */
+    private connect;
+    /**
+     * Schedule reconnection with exponential backoff
+     */
+    private scheduleReconnect;
+    /**
+     * Handle incoming task
+     */
+    private handleTask;
+    /**
+     * Report task completion to Core
+     */
+    private completeTask;
+    /**
+     * Register this agent installation with Sekuire
+     */
+    private bootstrap;
+    /**
+     * Start heartbeat loop
+     */
+    private startHeartbeat;
+}
+export declare function createWorker(config: WorkerConfig): TaskWorker;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sekuire/sdk",
-  "version": "0.1.8",
+  "version": "0.1.10",
   "description": "Sekuire Identity Protocol SDK for TypeScript/JavaScript",
   "type": "module",
   "main": "dist/index.js",
@@ -56,15 +56,21 @@
   "dependencies": {
     "@anthropic-ai/sdk": "^0.71.2",
     "@google/generative-ai": "^0.24.1",
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/exporter-trace-otlp-http": "^0.57.0",
+    "@opentelemetry/resources": "^1.29.0",
+    "@opentelemetry/sdk-trace-base": "^1.29.0",
+    "@opentelemetry/semantic-conventions": "^1.29.0",
     "axios": "^1.13.2",
     "blake3": "^2.1.7",
     "cheerio": "^1.1.2",
     "dotenv": "^17.2.3",
+    "eventsource": "^2.0.2",
     "js-yaml": "^4.1.1",
     "openai": "^6.15.0",
     "tweetnacl": "^1.0.3",
     "uuid": "^9.0.1",
-    "zod": "^4.2.1"
+    "zod": "^3.22.4"
   },
   "devDependencies": {
     "@biomejs/biome": "^1.9.4",
@@ -72,6 +78,7 @@
     "@rollup/plugin-json": "^6.1.0",
     "@rollup/plugin-node-resolve": "^15.3.1",
     "@rollup/plugin-typescript": "^11.1.6",
+    "@types/eventsource": "^1.1.15",
     "@types/js-yaml": "^4.0.9",
     "@types/node": "^20.19.27",
     "@types/uuid": "^9.0.8",