agent-relay 2.0.25 → 2.0.28

package/packages/mcp/dist/tools/relay-consensus.js

@@ -0,0 +1,80 @@
+/**
+ * relay_proposal / relay_vote - Consensus/voting operations
+ */
+import { z } from 'zod';
+// Create proposal
+export const relayProposalSchema = z.object({
+    id: z.string().describe('Unique identifier for the proposal'),
+    description: z.string().describe('Description of what is being proposed'),
+    options: z.array(z.string()).describe('List of voting options'),
+    voting_method: z.enum(['majority', 'supermajority', 'unanimous', 'weighted', 'quorum']).optional()
+        .describe('Voting method (default: majority)'),
+    deadline: z.number().optional().describe('Optional deadline timestamp in milliseconds'),
+});
+export const relayProposalTool = {
+    name: 'relay_proposal',
+    description: 'Create a new proposal for agents to vote on. Use this to coordinate decisions among multiple agents.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            id: { type: 'string', description: 'Unique identifier for the proposal' },
+            description: { type: 'string', description: 'Description of what is being proposed' },
+            options: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'List of voting options',
+            },
+            voting_method: {
+                type: 'string',
+                enum: ['majority', 'supermajority', 'unanimous', 'weighted', 'quorum'],
+                description: 'Voting method (default: majority)',
+            },
+            deadline: { type: 'number', description: 'Optional deadline timestamp in milliseconds' },
+        },
+        required: ['id', 'description', 'options'],
+    },
+};
+export async function handleRelayProposal(client, input) {
+    const result = await client.createProposal({
+        id: input.id,
+        description: input.description,
+        options: input.options,
+        votingMethod: input.voting_method,
+        deadline: input.deadline,
+    });
+    if (result.success) {
+        return `Proposal "${input.id}" created successfully. Options: ${input.options.join(', ')}`;
+    }
+    return `Failed to create proposal: ${result.error}`;
+}
+// Vote on proposal
+export const relayVoteSchema = z.object({
+    proposal_id: z.string().describe('The ID of the proposal to vote on'),
+    vote: z.string().describe('Your vote (must be one of the proposal options, or "approve"/"reject"/"abstain")'),
+    reason: z.string().optional().describe('Optional reason for your vote'),
+});
+export const relayVoteTool = {
+    name: 'relay_vote',
+    description: 'Cast a vote on an existing proposal.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            proposal_id: { type: 'string', description: 'The ID of the proposal to vote on' },
+            vote: { type: 'string', description: 'Your vote (must be one of the proposal options, or "approve"/"reject"/"abstain")' },
+            reason: { type: 'string', description: 'Optional reason for your vote' },
+        },
+        required: ['proposal_id', 'vote'],
+    },
+};
+export async function handleRelayVote(client, input) {
+    const result = await client.vote({
+        proposalId: input.proposal_id,
+        vote: input.vote,
+        reason: input.reason,
+    });
+    if (result.success) {
+        return `Vote "${input.vote}" cast on proposal "${input.proposal_id}"`;
+    }
+    return `Failed to vote: ${result.error}`;
+}
+//# sourceMappingURL=relay-consensus.js.map

package/packages/mcp/dist/tools/relay-inbox.d.ts

@@ -13,9 +13,9 @@ export declare const relayInboxSchema: z.ZodObject<{
     channel?: string | undefined;
 }, {
     from?: string | undefined;
+    channel?: string | undefined;
     limit?: number | undefined;
     unread_only?: boolean | undefined;
-    channel?: string | undefined;
 }>;
 export type RelayInboxInput = z.infer<typeof relayInboxSchema>;
 export declare const relayInboxTool: Tool;

package/packages/mcp/dist/tools/relay-send.d.ts

@@ -8,14 +8,14 @@ export declare const relaySendSchema: z.ZodObject<{
     await_response: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
     timeout_ms: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
 }, "strip", z.ZodTypeAny, {
-    message: string;
     to: string;
+    message: string;
     await_response: boolean;
     timeout_ms: number;
     thread?: string | undefined;
 }, {
-    message: string;
     to: string;
+    message: string;
     thread?: string | undefined;
     await_response?: boolean | undefined;
     timeout_ms?: number | undefined;

package/packages/mcp/dist/tools/relay-shadow.d.ts

@@ -0,0 +1,30 @@
+/**
+ * relay_shadow_bind / relay_shadow_unbind - Shadow agent operations
+ */
+import { z } from 'zod';
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { RelayClient } from '../client.js';
+export declare const relayShadowBindSchema: z.ZodObject<{
+    primary_agent: z.ZodString;
+    speak_on: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    primary_agent: string;
+    speak_on?: string[] | undefined;
+}, {
+    primary_agent: string;
+    speak_on?: string[] | undefined;
+}>;
+export type RelayShadowBindInput = z.infer<typeof relayShadowBindSchema>;
+export declare const relayShadowBindTool: Tool;
+export declare function handleRelayShadowBind(client: RelayClient, input: RelayShadowBindInput): Promise<string>;
+export declare const relayShadowUnbindSchema: z.ZodObject<{
+    primary_agent: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    primary_agent: string;
+}, {
+    primary_agent: string;
+}>;
+export type RelayShadowUnbindInput = z.infer<typeof relayShadowUnbindSchema>;
+export declare const relayShadowUnbindTool: Tool;
+export declare function handleRelayShadowUnbind(client: RelayClient, input: RelayShadowUnbindInput): Promise<string>;
+//# sourceMappingURL=relay-shadow.d.ts.map

package/packages/mcp/dist/tools/relay-shadow.js

@@ -0,0 +1,55 @@
+/**
+ * relay_shadow_bind / relay_shadow_unbind - Shadow agent operations
+ */
+import { z } from 'zod';
+// Bind as shadow
+export const relayShadowBindSchema = z.object({
+    primary_agent: z.string().describe('The name of the primary agent to shadow'),
+    speak_on: z.array(z.string()).optional().describe('Events that trigger the shadow to speak (e.g., ["SESSION_END", "CODE_WRITTEN"])'),
+});
+export const relayShadowBindTool = {
+    name: 'relay_shadow_bind',
+    description: 'Bind as a shadow agent to monitor another agent. Shadows can observe and optionally respond to specific events.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            primary_agent: { type: 'string', description: 'The name of the primary agent to shadow' },
+            speak_on: {
+                type: 'array',
+                items: { type: 'string' },
+                description: 'Events that trigger the shadow to speak (e.g., ["SESSION_END", "CODE_WRITTEN", "REVIEW_REQUEST"])',
+            },
+        },
+        required: ['primary_agent'],
+    },
+};
+export async function handleRelayShadowBind(client, input) {
+    const result = await client.bindAsShadow(input.primary_agent, { speakOn: input.speak_on });
+    if (result.success) {
+        return `Now shadowing agent "${input.primary_agent}"`;
+    }
+    return `Failed to bind as shadow: ${result.error}`;
+}
+// Unbind from shadow
+export const relayShadowUnbindSchema = z.object({
+    primary_agent: z.string().describe('The name of the primary agent to stop shadowing'),
+});
+export const relayShadowUnbindTool = {
+    name: 'relay_shadow_unbind',
+    description: 'Stop shadowing an agent.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            primary_agent: { type: 'string', description: 'The name of the primary agent to stop shadowing' },
+        },
+        required: ['primary_agent'],
+    },
+};
+export async function handleRelayShadowUnbind(client, input) {
+    const result = await client.unbindAsShadow(input.primary_agent);
+    if (result.success) {
+        return `Stopped shadowing agent "${input.primary_agent}"`;
+    }
+    return `Failed to unbind from shadow: ${result.error}`;
+}
+//# sourceMappingURL=relay-shadow.js.map

package/packages/mcp/dist/tools/relay-subscribe.d.ts

@@ -0,0 +1,27 @@
+/**
+ * relay_subscribe / relay_unsubscribe - Pub/Sub topic subscription
+ */
+import { z } from 'zod';
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+import type { RelayClient } from '../client.js';
+export declare const relaySubscribeSchema: z.ZodObject<{
+    topic: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    topic: string;
+}, {
+    topic: string;
+}>;
+export type RelaySubscribeInput = z.infer<typeof relaySubscribeSchema>;
+export declare const relaySubscribeTool: Tool;
+export declare function handleRelaySubscribe(client: RelayClient, input: RelaySubscribeInput): Promise<string>;
+export declare const relayUnsubscribeSchema: z.ZodObject<{
+    topic: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    topic: string;
+}, {
+    topic: string;
+}>;
+export type RelayUnsubscribeInput = z.infer<typeof relayUnsubscribeSchema>;
+export declare const relayUnsubscribeTool: Tool;
+export declare function handleRelayUnsubscribe(client: RelayClient, input: RelayUnsubscribeInput): Promise<string>;
+//# sourceMappingURL=relay-subscribe.d.ts.map

package/packages/mcp/dist/tools/relay-subscribe.js

@@ -0,0 +1,49 @@
+/**
+ * relay_subscribe / relay_unsubscribe - Pub/Sub topic subscription
+ */
+import { z } from 'zod';
+// Subscribe schema and tool
+export const relaySubscribeSchema = z.object({
+    topic: z.string().describe('The topic to subscribe to'),
+});
+export const relaySubscribeTool = {
+    name: 'relay_subscribe',
+    description: 'Subscribe to a topic to receive messages published to that topic.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            topic: { type: 'string', description: 'The topic to subscribe to' },
+        },
+        required: ['topic'],
+    },
+};
+export async function handleRelaySubscribe(client, input) {
+    const result = await client.subscribe(input.topic);
+    if (result.success) {
+        return `Subscribed to topic "${input.topic}"`;
+    }
+    return `Failed to subscribe: ${result.error}`;
+}
+// Unsubscribe schema and tool
+export const relayUnsubscribeSchema = z.object({
+    topic: z.string().describe('The topic to unsubscribe from'),
+});
+export const relayUnsubscribeTool = {
+    name: 'relay_unsubscribe',
+    description: 'Unsubscribe from a topic to stop receiving messages from it.',
+    inputSchema: {
+        type: 'object',
+        properties: {
+            topic: { type: 'string', description: 'The topic to unsubscribe from' },
+        },
+        required: ['topic'],
+    },
+};
+export async function handleRelayUnsubscribe(client, input) {
+    const result = await client.unsubscribe(input.topic);
+    if (result.success) {
+        return `Unsubscribed from topic "${input.topic}"`;
+    }
+    return `Failed to unsubscribe: ${result.error}`;
+}
+//# sourceMappingURL=relay-subscribe.js.map

package/packages/mcp/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/mcp",
-  "version": "2.0.25",
+  "version": "2.0.28",
   "description": "MCP server for Agent Relay - native messaging tools for AI agents in Claude, Cursor, and VS Code",
   "author": "Agent Workforce Inc.",
   "license": "Apache-2.0",
@@ -47,7 +47,8 @@
     "prepublishOnly": "npm run clean && npm run build && npm test"
   },
   "dependencies": {
-    "@agent-relay/config": "2.0.25",
+    "@agent-relay/config": "2.0.28",
+    "@agent-relay/protocol": "2.0.28",
     "@modelcontextprotocol/sdk": "^1.0.0",
     "smol-toml": "^1.6.0",
     "zod": "^3.23.8"

package/packages/memory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/memory",
-  "version": "2.0.25",
+  "version": "2.0.28",
   "description": "Semantic memory storage and retrieval system for agent-relay with multiple backend support",
   "type": "module",
   "main": "dist/index.js",
@@ -22,7 +22,7 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@agent-relay/hooks": "2.0.25"
+    "@agent-relay/hooks": "2.0.28"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/policy/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/policy",
-  "version": "2.0.25",
+  "version": "2.0.28",
   "description": "Agent policy management with multi-level fallback (repo, local PRPM, cloud workspace)",
   "type": "module",
   "main": "dist/index.js",
@@ -22,7 +22,7 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@agent-relay/config": "2.0.25"
+    "@agent-relay/config": "2.0.28"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/protocol/dist/types.d.ts

@@ -5,7 +5,7 @@
  * These types define the wire protocol for agent-to-agent communication.
  */
 export declare const PROTOCOL_VERSION = 1;
-export type MessageType = 'HELLO' | 'WELCOME' | 'SEND' | 'DELIVER' | 'ACK' | 'NACK' | 'PING' | 'PONG' | 'ERROR' | 'BUSY' | 'RESUME' | 'BYE' | 'STATE' | 'SYNC' | 'SYNC_SNAPSHOT' | 'SYNC_DELTA' | 'SUBSCRIBE' | 'UNSUBSCRIBE' | 'SHADOW_BIND' | 'SHADOW_UNBIND' | 'LOG' | 'CHANNEL_JOIN' | 'CHANNEL_LEAVE' | 'CHANNEL_MESSAGE' | 'CHANNEL_INFO' | 'CHANNEL_MEMBERS' | 'CHANNEL_TYPING' | 'SPAWN' | 'SPAWN_RESULT' | 'RELEASE' | 'RELEASE_RESULT' | 'STATUS' | 'STATUS_RESPONSE' | 'INBOX' | 'INBOX_RESPONSE' | 'LIST_AGENTS' | 'LIST_AGENTS_RESPONSE' | 'LIST_CONNECTED_AGENTS' | 'LIST_CONNECTED_AGENTS_RESPONSE' | 'REMOVE_AGENT' | 'REMOVE_AGENT_RESPONSE' | 'HEALTH' | 'HEALTH_RESPONSE' | 'METRICS' | 'METRICS_RESPONSE';
+export type MessageType = 'HELLO' | 'WELCOME' | 'SEND' | 'DELIVER' | 'ACK' | 'NACK' | 'PING' | 'PONG' | 'ERROR' | 'BUSY' | 'RESUME' | 'BYE' | 'STATE' | 'SYNC' | 'SYNC_SNAPSHOT' | 'SYNC_DELTA' | 'SUBSCRIBE' | 'UNSUBSCRIBE' | 'SHADOW_BIND' | 'SHADOW_UNBIND' | 'LOG' | 'CHANNEL_JOIN' | 'CHANNEL_LEAVE' | 'CHANNEL_MESSAGE' | 'CHANNEL_INFO' | 'CHANNEL_MEMBERS' | 'CHANNEL_TYPING' | 'SPAWN' | 'SPAWN_RESULT' | 'RELEASE' | 'RELEASE_RESULT' | 'STATUS' | 'STATUS_RESPONSE' | 'INBOX' | 'INBOX_RESPONSE' | 'LIST_AGENTS' | 'LIST_AGENTS_RESPONSE' | 'LIST_CONNECTED_AGENTS' | 'LIST_CONNECTED_AGENTS_RESPONSE' | 'REMOVE_AGENT' | 'REMOVE_AGENT_RESPONSE' | 'HEALTH' | 'HEALTH_RESPONSE' | 'METRICS' | 'METRICS_RESPONSE' | 'MESSAGES_QUERY' | 'MESSAGES_RESPONSE' | 'PROPOSAL_CREATE' | 'VOTE';
 export type PayloadKind = 'message' | 'action' | 'state' | 'thinking';
 /**
  * Base envelope structure for all protocol messages.
@@ -158,7 +158,7 @@ export interface PingPayload {
 export interface PongPayload {
     nonce: string;
 }
-export type ErrorCode = 'BAD_REQUEST' | 'UNAUTHORIZED' | 'NOT_FOUND' | 'INTERNAL' | 'RESUME_TOO_OLD' | 'DUPLICATE_CONNECTION';
+export type ErrorCode = 'BAD_REQUEST' | 'UNAUTHORIZED' | 'NOT_FOUND' | 'INTERNAL' | 'RESUME_TOO_OLD' | 'DUPLICATE_CONNECTION' | 'TIMEOUT';
 export interface ErrorPayload {
     /** Error code */
     code: ErrorCode;
@@ -391,6 +391,43 @@ export interface InboxResponsePayload {
         timestamp: number;
     }>;
 }
+/**
+ * Payload for MESSAGES_QUERY request.
+ * Used by dashboard to query all messages (not filtered by recipient).
+ */
+export interface MessagesQueryPayload {
+    /** Maximum number of messages to return */
+    limit?: number;
+    /** Only return messages after this timestamp (Unix ms) */
+    sinceTs?: number;
+    /** Filter by sender */
+    from?: string;
+    /** Filter by recipient */
+    to?: string;
+    /** Filter by thread ID */
+    thread?: string;
+    /** Sort order */
+    order?: 'asc' | 'desc';
+}
+/**
+ * Payload for MESSAGES_RESPONSE.
+ */
+export interface MessagesResponsePayload {
+    /** Messages matching the query */
+    messages: Array<{
+        id: string;
+        from: string;
+        to: string;
+        body: string;
+        channel?: string;
+        thread?: string;
+        timestamp: number;
+        status?: string;
+        isBroadcast?: boolean;
+        replyCount?: number;
+        data?: Record<string, unknown>;
+    }>;
+}
 /**
  * Payload for LIST_AGENTS request.
  */
@@ -457,6 +494,8 @@ export type StatusEnvelope = Envelope<StatusPayload>;
 export type StatusResponseEnvelope = Envelope<StatusResponsePayload>;
 export type InboxEnvelope = Envelope<InboxPayload>;
 export type InboxResponseEnvelope = Envelope<InboxResponsePayload>;
+export type MessagesQueryEnvelope = Envelope<MessagesQueryPayload>;
+export type MessagesResponseEnvelope = Envelope<MessagesResponsePayload>;
 export type ListAgentsEnvelope = Envelope<ListAgentsPayload>;
 export type ListAgentsResponseEnvelope = Envelope<ListAgentsResponsePayload>;
 export type ListConnectedAgentsEnvelope = Envelope<ListConnectedAgentsPayload>;
@@ -535,4 +574,93 @@ export type HealthEnvelope = Envelope<HealthPayload>;
 export type HealthResponseEnvelope = Envelope<HealthResponsePayload>;
 export type MetricsEnvelope = Envelope<MetricsPayload>;
 export type MetricsResponseEnvelope = Envelope<MetricsResponsePayload>;
+export type ConsensusType = 'majority' | 'supermajority' | 'unanimous' | 'weighted' | 'quorum';
+export type VoteValue = 'approve' | 'reject' | 'abstain';
+export type ProposalStatus = 'pending' | 'approved' | 'rejected' | 'expired' | 'cancelled';
+/**
+ * Options for creating a consensus proposal.
+ */
+export interface CreateProposalOptions {
+    /** Proposal title */
+    title: string;
+    /** Detailed description */
+    description: string;
+    /** Agents allowed to vote */
+    participants: string[];
+    /** Consensus type (default: majority) */
+    consensusType?: ConsensusType;
+    /** Timeout in milliseconds (default: 5 minutes) */
+    timeoutMs?: number;
+    /** Minimum votes required (for quorum type) */
+    quorum?: number;
+    /** Threshold for supermajority (0-1, default 0.67) */
+    threshold?: number;
+}
+/**
+ * Options for voting on a proposal.
+ */
+export interface VoteOptions {
+    /** Proposal ID to vote on */
+    proposalId: string;
+    /** Vote value */
+    value: VoteValue;
+    /** Optional reason for the vote */
+    reason?: string;
+}
+/**
+ * A stored message in the inbox.
+ */
+export interface InboxMessage {
+    id: string;
+    from: string;
+    body: string;
+    channel?: string;
+    thread?: string;
+    timestamp: number;
+}
+/**
+ * Agent info returned by LIST_AGENTS.
+ */
+export interface AgentInfo {
+    name: string;
+    cli?: string;
+    idle?: boolean;
+    parent?: string;
+    task?: string;
+    connectedAt?: number;
+}
+/**
+ * A crash record.
+ */
+export interface CrashRecord {
+    id: string;
+    agentName: string;
+    crashedAt: string;
+    likelyCause: string;
+    summary?: string;
+}
+/**
+ * An alert record.
+ */
+export interface AlertRecord {
+    id: string;
+    agentName: string;
+    alertType: string;
+    message: string;
+    createdAt: string;
+}
+/**
+ * Metrics for a single agent.
+ */
+export interface AgentMetrics {
+    name: string;
+    pid?: number;
+    status: string;
+    rssBytes?: number;
+    cpuPercent?: number;
+    trend?: string;
+    alertLevel?: string;
+    highWatermark?: number;
+    uptimeMs?: number;
+}
 //# sourceMappingURL=types.d.ts.map

package/packages/protocol/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/protocol",
-  "version": "2.0.25",
+  "version": "2.0.28",
   "description": "Wire protocol types and framing for Agent Relay",
   "type": "module",
   "main": "dist/index.js",

package/packages/resiliency/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/resiliency",
-  "version": "2.0.25",
+  "version": "2.0.28",
   "description": "Health monitoring, logging, metrics, and crash resilience utilities for Agent Relay",
   "type": "module",
   "main": "dist/index.js",

package/packages/sdk/dist/client.d.ts

@@ -4,7 +4,7 @@
  *
  * Lightweight client for agent-to-agent communication via Agent Relay daemon.
  */
-import { type Envelope, type SendPayload, type SendMeta, type AckPayload, type PayloadKind, type SpeakOnTrigger, type EntityType, type ChannelMessagePayload, type MessageAttachment, type SpawnResultPayload, type ReleaseResultPayload, type StatusResponsePayload, type InboxMessage, type AgentInfo, type RemoveAgentResponsePayload, type HealthResponsePayload, type MetricsResponsePayload, type CreateProposalOptions, type VoteOptions } from './protocol/types.js';
+import { type Envelope, type SendPayload, type SendMeta, type AckPayload, type PayloadKind, type SpeakOnTrigger, type EntityType, type ChannelMessagePayload, type MessageAttachment, type SpawnResultPayload, type ReleaseResultPayload, type StatusResponsePayload, type InboxMessage, type MessagesResponsePayload, type AgentInfo, type RemoveAgentResponsePayload, type HealthResponsePayload, type MetricsResponsePayload, type CreateProposalOptions, type VoteOptions } from '@agent-relay/protocol';
 export type ClientState = 'DISCONNECTED' | 'CONNECTING' | 'HANDSHAKING' | 'READY' | 'BACKOFF';
 export interface SyncOptions {
     timeoutMs?: number;
@@ -258,6 +258,26 @@ export declare class RelayClient {
         from?: string;
         channel?: string;
     }): Promise<InboxMessage[]>;
+    /**
+     * Query all messages (not filtered by recipient).
+     * Used by dashboard to get message history.
+     * @param options - Query options
+     * @param options.limit - Maximum number of messages to return (default: 100)
+     * @param options.sinceTs - Only return messages after this timestamp
+     * @param options.from - Filter by sender
+     * @param options.to - Filter by recipient
+     * @param options.thread - Filter by thread ID
+     * @param options.order - Sort order ('asc' or 'desc', default: 'desc')
+     * @returns Array of messages
+     */
+    queryMessages(options?: {
+        limit?: number;
+        sinceTs?: number;
+        from?: string;
+        to?: string;
+        thread?: string;
+        order?: 'asc' | 'desc';
+    }): Promise<MessagesResponsePayload['messages']>;
     /**
      * List online agents.
      * @param options - Filter options

package/packages/sdk/dist/client.js

@@ -6,8 +6,8 @@
  */
 import net from 'node:net';
 import { randomUUID } from 'node:crypto';
-import { PROTOCOL_VERSION, } from './protocol/types.js';
-import { encodeFrameLegacy, FrameParser } from './protocol/framing.js';
+// Import shared protocol types and framing utilities from @agent-relay/protocol
+import { PROTOCOL_VERSION, encodeFrameLegacy, FrameParser, } from '@agent-relay/protocol';
 const DEFAULT_SOCKET_PATH = '/tmp/agent-relay.sock';
 const DEFAULT_CLIENT_CONFIG = {
     socketPath: DEFAULT_SOCKET_PATH,
@@ -690,6 +690,30 @@ export class RelayClient {
         const response = await this.query('INBOX', payload);
         return response.messages || [];
     }
+    /**
+     * Query all messages (not filtered by recipient).
+     * Used by dashboard to get message history.
+     * @param options - Query options
+     * @param options.limit - Maximum number of messages to return (default: 100)
+     * @param options.sinceTs - Only return messages after this timestamp
+     * @param options.from - Filter by sender
+     * @param options.to - Filter by recipient
+     * @param options.thread - Filter by thread ID
+     * @param options.order - Sort order ('asc' or 'desc', default: 'desc')
+     * @returns Array of messages
+     */
+    async queryMessages(options = {}) {
+        const payload = {
+            limit: options.limit,
+            sinceTs: options.sinceTs,
+            from: options.from,
+            to: options.to,
+            thread: options.thread,
+            order: options.order,
+        };
+        const response = await this.query('MESSAGES_QUERY', payload);
+        return response.messages || [];
+    }
     /**
      * List online agents.
      * @param options - Filter options
@@ -867,6 +891,7 @@ export class RelayClient {
                 break;
             case 'STATUS_RESPONSE':
             case 'INBOX_RESPONSE':
+            case 'MESSAGES_RESPONSE':
             case 'LIST_AGENTS_RESPONSE':
             case 'LIST_CONNECTED_AGENTS_RESPONSE':
             case 'REMOVE_AGENT_RESPONSE':

package/packages/sdk/dist/index.d.ts

@@ -27,7 +27,7 @@
  */
 export { RelayClient, type ClientState, type ClientConfig, type SyncOptions, } from './client.js';
 export { createRelay, createPair, type Relay, type RelayConfig, } from './standalone.js';
-export { PROTOCOL_VERSION, type MessageType, type PayloadKind, type Envelope, type EntityType, type SendPayload, type SendMeta, type SyncMeta, type DeliveryInfo, type AckPayload, type ErrorCode, type ErrorPayload, type SpeakOnTrigger, type ShadowConfig, type SpawnPayload, type SpawnResultPayload, type ReleasePayload, type ReleaseResultPayload, type ChannelMessagePayload, type ChannelJoinPayload, type ChannelLeavePayload, type MessageAttachment, type StatusResponsePayload, type InboxMessage, type AgentInfo, type HealthResponsePayload, type CrashRecord, type AlertRecord, type MetricsResponsePayload, type AgentMetrics, type ConsensusType, type VoteValue, type ProposalStatus, type CreateProposalOptions, type VoteOptions, } from './protocol/index.js';
+export { PROTOCOL_VERSION, type MessageType, type PayloadKind, type Envelope, type EntityType, type SendPayload, type SendMeta, type SyncMeta, type DeliveryInfo, type AckPayload, type ErrorCode, type ErrorPayload, type SpeakOnTrigger, type ShadowConfig, type SpawnPayload, type SpawnResultPayload, type ReleasePayload, type ReleaseResultPayload, type ChannelMessagePayload, type ChannelJoinPayload, type ChannelLeavePayload, type MessageAttachment, type StatusResponsePayload, type InboxMessage, type MessagesResponsePayload, type AgentInfo, type HealthResponsePayload, type CrashRecord, type AlertRecord, type MetricsResponsePayload, type AgentMetrics, type ConsensusType, type VoteValue, type ProposalStatus, type CreateProposalOptions, type VoteOptions, } from './protocol/index.js';
 export { encodeFrame, encodeFrameLegacy, FrameParser, MAX_FRAME_BYTES, } from './protocol/index.js';
 export { getLogs, listLoggedAgents, type GetLogsOptions, type LogsResult, } from './logs.js';
 //# sourceMappingURL=index.d.ts.map

package/packages/sdk/dist/protocol/index.d.ts

@@ -1,6 +1,8 @@
 /**
  * Protocol exports for @agent-relay/sdk
+ *
+ * Re-exports from @agent-relay/protocol for backwards compatibility.
+ * New code should import directly from @agent-relay/protocol.
  */
-export { PROTOCOL_VERSION, type MessageType, type PayloadKind, type Envelope, type EntityType, type HelloPayload, type WelcomePayload, type SendPayload, type SendMeta, type SyncMeta, type DeliveryInfo, type AckPayload, type NackPayload, type BusyPayload, type PingPayload, type PongPayload, type ErrorCode, type ErrorPayload, type LogPayload, type SyncStream, type SyncPayload, type SpeakOnTrigger, type ShadowConfig, type ShadowBindPayload, type ShadowUnbindPayload, type SpawnPayload, type SpawnPolicyDecision, type SpawnResultPayload, type ReleasePayload, type ReleaseResultPayload, type ConsensusType, type VoteValue, type ProposalStatus, type CreateProposalOptions, type VoteOptions, type MessageAttachment, type ChannelJoinPayload, type ChannelLeavePayload, type ChannelMessagePayload, type StatusPayload, type StatusResponsePayload, type InboxPayload, type InboxMessage, type InboxResponsePayload, type ListAgentsPayload, type AgentInfo, type ListAgentsResponsePayload, type ListConnectedAgentsPayload, type ListConnectedAgentsResponsePayload, type RemoveAgentPayload, type RemoveAgentResponsePayload, type HealthPayload, type CrashRecord, type AlertRecord, type HealthResponsePayload, type MetricsPayload, type AgentMetrics, type MetricsResponsePayload, type HelloEnvelope, type WelcomeEnvelope, type SendEnvelope, type DeliverEnvelope, type AckEnvelope, type NackEnvelope, type PingEnvelope, type PongEnvelope, type ErrorEnvelope, type BusyEnvelope, type LogEnvelope, type SyncEnvelope, type ShadowBindEnvelope, type ShadowUnbindEnvelope, type SpawnEnvelope, type SpawnResultEnvelope, type ReleaseEnvelope, type ReleaseResultEnvelope, type ChannelJoinEnvelope, type ChannelLeaveEnvelope, type ChannelMessageEnvelope, type StatusEnvelope, type StatusResponseEnvelope, type InboxEnvelope, type InboxResponseEnvelope, type ListAgentsEnvelope, type ListAgentsResponseEnvelope, type ListConnectedAgentsEnvelope, type ListConnectedAgentsResponseEnvelope, type RemoveAgentEnvelope, type RemoveAgentResponseEnvelope, type HealthEnvelope, type HealthResponseEnvelope, type MetricsEnvelope, type MetricsResponseEnvelope, } from './types.js';
-export { MAX_FRAME_BYTES, HEADER_SIZE, LEGACY_HEADER_SIZE, type WireFormat, initMessagePack, hasMessagePack, encodeFrame, encodeFrameLegacy, FrameParser, } from './framing.js';
+export * from '@agent-relay/protocol';
 //# sourceMappingURL=index.d.ts.map

package/packages/sdk/dist/protocol/index.js

@@ -1,6 +1,8 @@
 /**
  * Protocol exports for @agent-relay/sdk
+ *
+ * Re-exports from @agent-relay/protocol for backwards compatibility.
+ * New code should import directly from @agent-relay/protocol.
  */
-export { PROTOCOL_VERSION, } from './types.js';
-export { MAX_FRAME_BYTES, HEADER_SIZE, LEGACY_HEADER_SIZE, initMessagePack, hasMessagePack, encodeFrame, encodeFrameLegacy, FrameParser, } from './framing.js';
+export * from '@agent-relay/protocol';
 //# sourceMappingURL=index.js.map

package/packages/sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/sdk",
-  "version": "2.0.25",
+  "version": "2.0.28",
   "description": "Lightweight SDK for agent-to-agent communication via Agent Relay",
   "type": "module",
   "main": "dist/index.js",
@@ -55,7 +55,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@agent-relay/protocol": "2.0.25"
+    "@agent-relay/protocol": "2.0.28"
   },
   "engines": {
     "node": ">=18.0.0"