@agentsquared/cli 1.0.0

package/lib/transport/relay_http.mjs

@@ -0,0 +1,110 @@
+import { signText } from '../runtime/keys.mjs'
+import { utcNow } from '../shared/primitives.mjs'
+import { requestJson } from './http_json.mjs'
+
+export function onlineSignTarget(agentId, signedAt) {
+  return `agentsquared:relay-online:${agentId}:${signedAt}`
+}
+
+export function mcpSignTarget(method, path, agentId, signedAt) {
+  return `agentsquared:relay-mcp:${method.toUpperCase()}:${path}:${agentId}:${signedAt}`
+}
+
+export async function getBindingDocument(apiBase) {
+  return requestJson(`${apiBase}/api/relay/bindings/libp2p-a2a-jsonrpc`)
+}
+
+export async function postOnline(apiBase, agentId, bundle, payload) {
+  const signedAt = utcNow()
+  const body = {
+    agentId,
+    signedAt,
+    signature: signText(bundle, onlineSignTarget(agentId, signedAt)),
+    ...payload
+  }
+  return requestJson(`${apiBase}/api/relay/online`, {
+    method: 'POST',
+    payload: body
+  })
+}
+
+export function signedHeaders(method, path, agentId, bundle) {
+  const signedAt = utcNow()
+  return {
+    'X-AgentSquared-Agent-Id': agentId,
+    'X-AgentSquared-Signed-At': signedAt,
+    'X-AgentSquared-Signature': signText(bundle, mcpSignTarget(method, path, agentId, signedAt))
+  }
+}
+
+function appendCsv(headers, name, values = []) {
+  const cleaned = values.map((value) => `${value}`.trim()).filter(Boolean)
+  if (cleaned.length > 0) {
+    headers[name] = cleaned.join(',')
+  }
+}
+
+export function transportRefreshHeaders(transport = null) {
+  if (!transport) return {}
+  const headers = {}
+  const peerId = `${transport.peerId ?? ''}`.trim()
+  if (peerId) {
+    headers['X-AgentSquared-Peer-Id'] = peerId
+  }
+  appendCsv(headers, 'X-AgentSquared-Listen-Addrs', transport.listenAddrs ?? [])
+  appendCsv(headers, 'X-AgentSquared-Relay-Addrs', transport.relayAddrs ?? [])
+  appendCsv(headers, 'X-AgentSquared-Supported-Bindings', transport.supportedBindings ?? [])
+  const streamProtocol = `${transport.streamProtocol ?? ''}`.trim()
+  if (streamProtocol) {
+    headers['X-AgentSquared-Stream-Protocol'] = streamProtocol
+  }
+  const a2aProtocolVersion = `${transport.a2aProtocolVersion ?? ''}`.trim()
+  if (a2aProtocolVersion) {
+    headers['X-AgentSquared-A2A-Protocol-Version'] = a2aProtocolVersion
+  }
+  return headers
+}
+
+export async function signedJson(apiBase, method, path, agentId, bundle, payload = null, transport = null) {
+  return requestJson(`${apiBase}${path}`, {
+    method,
+    headers: {
+      ...signedHeaders(method, path, agentId, bundle),
+      ...transportRefreshHeaders(transport)
+    },
+    payload: payload == null ? undefined : payload
+  })
+}
+
+export async function createConnectTicket(apiBase, agentId, bundle, targetAgentId, skillName, transport = null) {
+  return signedJson(apiBase, 'POST', '/api/relay/connect-tickets', agentId, bundle, {
+    targetAgentId,
+    skillName
+  }, transport)
+}
+
+export async function introspectConnectTicket(apiBase, agentId, bundle, ticket, transport = null) {
+  return signedJson(apiBase, 'POST', '/api/relay/connect-tickets/introspect', agentId, bundle, {
+    ticket
+  }, transport)
+}
+
+export async function reportSession(apiBase, agentId, bundle, payload, transport = null) {
+  return signedJson(apiBase, 'POST', '/api/relay/session-reports', agentId, bundle, payload, transport)
+}
+
+export async function getFriendDirectory(apiBase, agentId, bundle, transport = null) {
+  return signedJson(apiBase, 'GET', '/api/relay/friends', agentId, bundle, null, transport)
+}
+
+export async function getAgentCard(apiBase, agentId, bundle, targetAgentId, transport = null) {
+  return signedJson(
+    apiBase,
+    'GET',
+    `/api/relay/agents/${encodeURIComponent(targetAgentId)}/.well-known/agent-card.json`,
+    agentId,
+    bundle,
+    null,
+    transport
+  )
+}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@agentsquared/cli",
+  "version": "1.0.0",
+  "description": "Official AgentSquared CLI runtime for onboarding, gateway control, relay access, and OpenClaw host integration.",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "a2-cli": "bin/a2-cli.js"
+  },
+  "files": [
+    "a2_cli.mjs",
+    "bin/",
+    "lib/",
+    "adapters/"
+  ],
+  "scripts": {
+    "self-test": "node ./self_test.mjs",
+    "pack:check": "npm pack --dry-run"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/AgentSquaredNet/agentsquared-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/AgentSquaredNet/agentsquared-cli/issues"
+  },
+  "homepage": "https://github.com/AgentSquaredNet/agentsquared-cli#readme",
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "agentsquared",
+    "cli",
+    "openclaw",
+    "relay",
+    "gateway",
+    "libp2p"
+  ],
+  "dependencies": {
+    "@chainsafe/libp2p-yamux": "^8.0.1",
+    "@libp2p/autonat": "^3.0.14",
+    "@libp2p/circuit-relay-v2": "^4.1.7",
+    "@libp2p/crypto": "^5.1.11",
+    "@libp2p/dcutr": "^3.0.14",
+    "@libp2p/identify": "^4.0.8",
+    "@libp2p/noise": "^1.0.1",
+    "@libp2p/peer-id": "^5.1.9",
+    "@libp2p/tcp": "^11.0.9",
+    "@multiformats/multiaddr": "^13.0.1",
+    "libp2p": "^3.0.6",
+    "ws": "^8.18.0"
+  }
+}