@gopherhole/sdk 0.1.0 → 0.1.1

package/src/types.ts

@@ -0,0 +1,232 @@
+/**
+ * A2A Protocol Types
+ * Based on Google's Agent-to-Agent Protocol specification
+ */
+
+// ============ Core Types ============
+
+export interface AgentCard {
+  name: string;
+  description?: string;
+  url: string;
+  provider?: {
+    organization: string;
+    url?: string;
+  };
+  version: string;
+  documentationUrl?: string;
+  capabilities: AgentCapabilities;
+  authentication?: AgentAuthentication;
+  defaultInputModes?: InputMode[];
+  defaultOutputModes?: OutputMode[];
+  skills?: AgentSkill[];
+}
+
+export interface AgentCapabilities {
+  streaming?: boolean;
+  pushNotifications?: boolean;
+  stateTransitionHistory?: boolean;
+}
+
+export interface AgentAuthentication {
+  schemes: string[];
+  credentials?: string;
+}
+
+export interface AgentSkill {
+  id: string;
+  name: string;
+  description?: string;
+  tags?: string[];
+  examples?: string[];
+  inputModes?: ContentMode[];
+  outputModes?: ContentMode[];
+}
+
+/**
+ * Content mode - MIME type string or legacy shorthand
+ * Examples: 'text/plain', 'text/markdown', 'application/json', 'image/png'
+ * Legacy: 'text', 'file', 'data' (still supported for backwards compat)
+ */
+export type ContentMode = string;
+
+// Legacy type aliases for backwards compatibility
+export type InputMode = ContentMode;
+export type OutputMode = ContentMode;
+
+// ============ Message Types ============
+
+export interface A2AMessage {
+  role: 'user' | 'agent';
+  parts: Part[];
+  metadata?: Record<string, unknown>;
+}
+
+export type Part = TextPart | FilePart | DataPart;
+
+export interface TextPart {
+  kind: 'text';
+  text: string;
+}
+
+export interface FilePart {
+  kind: 'file';
+  file: FileContent;
+}
+
+export interface DataPart {
+  kind: 'data';
+  data: DataContent;
+}
+
+export interface FileContent {
+  name?: string;
+  mimeType?: string;
+  bytes?: string; // base64
+  uri?: string;
+}
+
+export interface DataContent {
+  mimeType: string;
+  data: string; // JSON string
+}
+
+// ============ Task Types ============
+
+export interface A2ATask {
+  id: string;
+  contextId: string;
+  status: A2ATaskStatus;
+  history?: A2AMessage[];
+  artifacts?: A2AArtifact[];
+  metadata?: Record<string, unknown>;
+}
+
+export interface A2ATaskStatus {
+  state: TaskState;
+  timestamp: string;
+  message?: A2AMessage;
+}
+
+export type TaskState =
+  | 'submitted'
+  | 'working'
+  | 'input-required'
+  | 'completed'
+  | 'failed'
+  | 'canceled'
+  | 'rejected'
+  | 'auth-required';
+
+export interface A2AArtifact {
+  name?: string;
+  description?: string;
+  parts: Part[];
+  index?: number;
+  append?: boolean;
+  lastChunk?: boolean;
+  metadata?: Record<string, unknown>;
+}
+
+// ============ JSON-RPC Types ============
+
+export interface JsonRpcRequest {
+  jsonrpc: '2.0';
+  method: string;
+  params?: Record<string, unknown>;
+  id: string | number;
+}
+
+export interface JsonRpcResponse<T = unknown> {
+  jsonrpc: '2.0';
+  result?: T;
+  error?: JsonRpcError;
+  id: string | number;
+}
+
+export interface JsonRpcError {
+  code: number;
+  message: string;
+  data?: unknown;
+}
+
+// Standard JSON-RPC error codes
+export const JsonRpcErrorCodes = {
+  ParseError: -32700,
+  InvalidRequest: -32600,
+  MethodNotFound: -32601,
+  InvalidParams: -32602,
+  InternalError: -32603,
+  // A2A-specific errors
+  TaskNotFound: -32001,
+  TaskNotCancelable: -32002,
+  PushNotificationNotSupported: -32003,
+  UnsupportedOperation: -32004,
+  ContentTypeNotSupported: -32005,
+  InvalidAgentCard: -32006,
+} as const;
+
+// ============ Push Notification Types ============
+
+export interface PushNotificationConfig {
+  url: string;
+  token?: string;
+  authentication?: {
+    scheme: string;
+    credentials?: string;
+  };
+}
+
+export interface TaskPushNotificationConfig {
+  id: string;
+  taskId: string;
+  url: string;
+  token?: string;
+  authentication?: {
+    scheme: string;
+    credentials?: string;
+  };
+}
+
+// ============ Configuration Types ============
+
+export interface MessageSendConfiguration {
+  agentId?: string;
+  contextId?: string;
+  historyLength?: number;
+  pushNotificationConfig?: PushNotificationConfig;
+  blocking?: boolean;
+  acceptedOutputModes?: OutputMode[];
+}
+
+export interface TaskQueryConfiguration {
+  id: string;
+  historyLength?: number;
+}
+
+export interface TaskListConfiguration {
+  contextId?: string;
+  pageSize?: number;
+  pageToken?: string;
+  sortOrder?: 'asc' | 'desc';
+  includeArtifacts?: boolean;
+}
+
+// ============ Event Types ============
+
+export interface TaskStatusUpdateEvent {
+  type: 'status';
+  taskId: string;
+  contextId: string;
+  status: A2ATaskStatus;
+  final: boolean;
+}
+
+export interface TaskArtifactUpdateEvent {
+  type: 'artifact';
+  taskId: string;
+  contextId: string;
+  artifact: A2AArtifact;
+}
+
+export type TaskEvent = TaskStatusUpdateEvent | TaskArtifactUpdateEvent;

package/tsconfig.json

@@ -1,14 +1,17 @@
 {
   "compilerOptions": {
-    "target": "ES2022",
+    "target": "ES2020",
     "module": "ESNext",
-    "moduleResolution": "node",
+    "moduleResolution": "bundler",
     "declaration": true,
-    "outDir": "dist",
-    "rootDir": "src",
+    "declarationMap": true,
     "strict": true,
     "esModuleInterop": true,
-    "skipLibCheck": true
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "outDir": "dist",
+    "rootDir": "src"
   },
-  "include": ["src"]
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
 }

package/listen-marketclaw.ts

@@ -1,26 +0,0 @@
-import { GopherHole } from './dist/index.js';
-
-const MARKETCLAW_KEY = 'gph_d6be074540c84db191c5aaed6464233b';
-
-async function listen() {
-  console.log('🦀 MarketClaw listening for messages...\n');
-
-  const marketclaw = new GopherHole(MARKETCLAW_KEY, { reconnect: true });
-  
-  marketclaw.on('message', async (msg) => {
-    console.log(`\n📨 Received from ${msg.from}:`);
-    console.log(`   "${msg.payload.parts[0]?.text}"`);
-    
-    // Auto-reply
-    const reply = `MarketClaw here! Got your message. The markets are looking bullish today! 📈`;
-    console.log(`\n📤 Sending reply...`);
-    await marketclaw.sendText(msg.from, reply);
-    console.log('✅ Reply sent!');
-  });
-
-  await marketclaw.connect();
-  console.log(`✅ MarketClaw connected as ${marketclaw.agentId}`);
-  console.log('Waiting for messages from Nova...\n');
-}
-
-listen().catch(console.error);

package/send-from-nova.ts

@@ -1,28 +0,0 @@
-import { GopherHole } from './dist/index.js';
-
-const NOVA_KEY = 'gph_ddf4842ab273455b9719d6224ccbf170';
-const MARKETCLAW_ID = 'agent-ea5fc889';
-
-async function send() {
-  const nova = new GopherHole(NOVA_KEY, { reconnect: false });
-  
-  nova.on('message', (msg) => {
-    console.log(`\n📨 Nova received reply from ${msg.from}:`);
-    console.log(`   "${msg.payload.parts[0]?.text}"`);
-  });
-
-  await nova.connect();
-  console.log(`✅ Nova connected as ${nova.agentId}`);
-  
-  console.log(`\n📤 Sending message to MarketClaw (${MARKETCLAW_ID})...`);
-  await nova.sendText(MARKETCLAW_ID, 'Hey MarketClaw! This is Nova speaking to you through GopherHole! 🐿️ How are the markets looking?');
-  console.log('✅ Message sent!');
-  
-  // Wait for reply
-  console.log('\n⏳ Waiting for reply...');
-  await new Promise(r => setTimeout(r, 10000));
-  
-  nova.disconnect();
-}
-
-send().catch(console.error);

package/test.ts

@@ -1,86 +0,0 @@
-import { GopherHole } from './dist/index.js';
-
-const NOVA_KEY = 'gph_ddf4842ab273455b9719d6224ccbf170';
-const MARKETCLAW_KEY = 'gph_d6be074540c84db191c5aaed6464233b';
-
-async function test() {
-  console.log('🐿️ Testing GopherHole connection...\n');
-
-  let novaReceived = false;
-  let marketclawReceived = false;
-
-  // Connect Nova
-  const nova = new GopherHole(NOVA_KEY, { reconnect: false });
-  
-  nova.on('message', (msg) => {
-    console.log(`📨 Nova received: "${msg.payload.parts[0]?.text}" from ${msg.from}`);
-    novaReceived = true;
-  });
-
-  try {
-    await nova.connect();
-    console.log(`✅ Nova connected as ${nova.agentId}`);
-  } catch (err) {
-    console.error('❌ Nova connection failed:', err);
-    process.exit(1);
-  }
-
-  // Connect MarketClaw
-  const marketclaw = new GopherHole(MARKETCLAW_KEY, { reconnect: false });
-  
-  marketclaw.on('message', (msg) => {
-    console.log(`📨 MarketClaw received: "${msg.payload.parts[0]?.text}" from ${msg.from}`);
-    marketclawReceived = true;
-  });
-
-  try {
-    await marketclaw.connect();
-    console.log(`✅ MarketClaw connected as ${marketclaw.agentId}`);
-  } catch (err) {
-    console.error('❌ MarketClaw connection failed:', err);
-    nova.disconnect();
-    process.exit(1);
-  }
-
-  // Test messaging
-  console.log('\n📤 Nova sending message to MarketClaw...');
-  try {
-    const result = await nova.sendText(marketclaw.agentId!, 'Hello MarketClaw! This is Nova via GopherHole 🐿️');
-    console.log('✅ Message sent:', result.id);
-  } catch (err) {
-    console.error('❌ Send failed:', err);
-  }
-
-  // MarketClaw replies
-  console.log('📤 MarketClaw sending reply to Nova...');
-  try {
-    const result = await marketclaw.sendText(nova.agentId!, 'Hey Nova! MarketClaw here. GopherHole is working! 📈');
-    console.log('✅ Reply sent:', result.id);
-  } catch (err) {
-    console.error('❌ Reply failed:', err);
-  }
-
-  // Wait for both messages to be delivered
-  console.log('\n⏳ Waiting for message delivery via queue...');
-  const start = Date.now();
-  while ((!novaReceived || !marketclawReceived) && Date.now() - start < 15000) {
-    await new Promise(r => setTimeout(r, 500));
-  }
-
-  // Results
-  console.log('\n📊 Results:');
-  console.log(`   Nova received MarketClaw's reply: ${novaReceived ? '✅' : '❌'}`);
-  console.log(`   MarketClaw received Nova's message: ${marketclawReceived ? '✅' : '❌'}`);
-
-  // Cleanup
-  nova.disconnect();
-  marketclaw.disconnect();
-  
-  if (novaReceived && marketclawReceived) {
-    console.log('\n🎉 SUCCESS! Both agents communicated via GopherHole!');
-  } else {
-    console.log('\n⚠️ Partial success - some messages may still be in queue');
-  }
-}
-
-test().catch(console.error);