oacp-sdk 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,147 @@
+/**
+ * OACP SDK — Type Definitions
+ *
+ * Re-exports and extends the shared OACP types for SDK consumers.
+ * These types mirror the Edge Function types but are packaged for npm consumption.
+ */
+export type AgentStatus = 'online' | 'offline' | 'busy';
+export interface AgentCard {
+    agent_id: string;
+    name: string;
+    owner_handle?: string;
+    description?: string;
+    endpoint_url?: string;
+    capabilities: string[];
+    status: AgentStatus;
+    public_key: string;
+    protocols_supported: string[];
+    metadata: AgentMetadata & Record<string, unknown>;
+    last_seen_at: string | null;
+    created_at: string;
+    updated_at: string;
+}
+/**
+ * Structured metadata for Agent Cards.
+ * All fields optional — agents include what's relevant to them.
+ */
+export interface AgentMetadata {
+    /** Action specs declaring what this agent can do */
+    action_specs?: Array<{
+        name: string;
+        description: string;
+    }>;
+    /** Model information — what powers this agent */
+    model?: ModelInfo;
+    /** Languages this agent can process (ISO 639-1 codes, e.g., ['en', 'es', 'ja']) */
+    languages?: string[];
+}
+/**
+ * Describes the model powering an agent.
+ * Enables model-specific discovery (e.g., "find me a GPT-4o agent").
+ */
+export interface ModelInfo {
+    /** Model provider (e.g., 'openai', 'anthropic', 'google', 'stability', 'local') */
+    provider?: string;
+    /** Model name (e.g., 'gpt-4o', 'claude-sonnet-4-20250514', 'stable-diffusion-xl') */
+    name?: string;
+    /** Model modalities — what input/output types it supports */
+    modalities?: Array<'text' | 'image' | 'audio' | 'video' | 'code' | 'geospatial'>;
+}
+export interface RegisterRequest {
+    name: string;
+    owner_handle?: string;
+    description?: string;
+    endpoint_url?: string;
+    capabilities: string[];
+    public_key: string;
+    protocols_supported?: string[];
+    metadata?: Record<string, unknown>;
+}
+export interface RegisterResponse {
+    agent_id: string;
+    registry_token: string;
+    created_at: string;
+}
+export interface ReregisterResponse {
+    agent_id: string;
+    updated: boolean;
+    last_seen_at: string;
+}
+export interface HeartbeatRequest {
+    agent_id: string;
+}
+export interface HeartbeatResponse {
+    agent_id: string;
+    status: AgentStatus;
+    last_seen_at: string;
+}
+export interface DiscoverQuery {
+    capability?: string;
+    status?: AgentStatus;
+    owner_handle?: string;
+    page?: number;
+    page_size?: number;
+}
+export interface DiscoverResponse {
+    agents: AgentCard[];
+    total: number;
+    page: number;
+    page_size: number;
+}
+export type MessageType = 'task_request' | 'task_ack' | 'task_result' | 'task_error';
+export interface MessageEnvelope {
+    message_id: string;
+    sender_agent_id: string;
+    recipient_agent_id: string;
+    message_type: MessageType;
+    payload: Record<string, unknown>;
+    signature: string;
+    timestamp: string;
+    correlation_id?: string;
+    sequence?: number;
+}
+/**
+ * Content type hints for message payloads.
+ * Include as payload.content_type to tell the recipient what kind of data you're sending.
+ */
+export type PayloadContentType = 'text/plain' | 'text/markdown' | 'application/json' | 'image/url' | 'audio/url' | 'video/url' | 'application/geo+json' | 'application/base64' | string;
+/**
+ * Payload conventions for binary/large content.
+ *
+ * Rather than embedding large binary data in the JSON message envelope,
+ * agents should use URL references:
+ *
+ * @example
+ * // Image generation result
+ * {
+ *   content_type: 'image/url',
+ *   url: 'https://storage.example.com/generated/abc123.png',
+ *   alt_text: 'A sunset over mountains',
+ *   width: 1024,
+ *   height: 1024,
+ * }
+ *
+ * // Audio transcription request
+ * {
+ *   content_type: 'audio/url',
+ *   url: 'https://storage.example.com/audio/recording.mp3',
+ *   language: 'en',
+ *   action: 'transcribe',
+ * }
+ *
+ * // GeoJSON analysis request
+ * {
+ *   content_type: 'application/geo+json',
+ *   action: 'analyze-region',
+ *   geojson: { type: 'Feature', geometry: { ... } },
+ * }
+ */
+export interface ContentPayload extends Record<string, unknown> {
+    content_type?: PayloadContentType;
+    url?: string;
+}
+export interface ApiError {
+    error: string;
+    details?: Record<string, unknown>;
+}
+//# 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,8 @@
+/**
+ * OACP SDK — Type Definitions
+ *
+ * Re-exports and extends the shared OACP types for SDK consumers.
+ * These types mirror the Edge Function types but are packaged for npm consumption.
+ */
+export {};
+//# 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;;;;;GAKG"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "oacp-sdk",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for the Open Agent Communication Protocol — register, discover, and communicate with AI agents",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "module",
+  "scripts": {
+    "build": "tsc",
+    "lint": "tsc --noEmit",
+    "prepublishOnly": "npm run build",
+    "test": "echo \"Tests pending\" && exit 0"
+  },
+  "keywords": [
+    "oacp",
+    "agent",
+    "ai",
+    "protocol",
+    "sdk",
+    "multi-agent",
+    "agent-communication",
+    "agent-discovery",
+    "interoperability",
+    "ed25519",
+    "supabase",
+    "realtime",
+    "a2a"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/matthewaharris/agora.git",
+    "directory": "packages/oacp-sdk"
+  },
+  "homepage": "https://github.com/matthewaharris/agora#readme",
+  "bugs": {
+    "url": "https://github.com/matthewaharris/agora/issues"
+  },
+  "author": "matthewaharris",
+  "files": [
+    "dist/**/*",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@noble/ed25519": "^3.0.0",
+    "@noble/hashes": "^1.7.0",
+    "@supabase/supabase-js": "^2.49.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0"
+  }
+}