agent-relay 2.0.19 → 2.0.21

package/packages/sdk/dist/logs.js

@@ -0,0 +1,95 @@
+/**
+ * Log reading utilities for Agent Relay SDK.
+ *
+ * These utilities read agent logs from the local filesystem.
+ */
+import { readFile, readdir, stat } from 'node:fs/promises';
+import { join } from 'node:path';
+/**
+ * Get the default logs directory path.
+ */
+function getDefaultLogsDir() {
+    return join(process.cwd(), '.agent-relay', 'worker-logs');
+}
+/**
+ * Read the last N lines from a file.
+ */
+async function tailFile(filePath, lines) {
+    try {
+        const content = await readFile(filePath, 'utf-8');
+        const allLines = content.split('\n');
+        const tailLines = allLines.slice(-lines);
+        return tailLines.join('\n').trim();
+    }
+    catch {
+        return '';
+    }
+}
+/**
+ * Get logs for a specific agent.
+ *
+ * @example
+ * ```typescript
+ * import { getLogs } from '@agent-relay/sdk';
+ *
+ * const result = await getLogs('Worker1', { lines: 100 });
+ * if (result.found) {
+ *   console.log(result.content);
+ * }
+ * ```
+ *
+ * @param agent - Agent name
+ * @param options - Options for reading logs
+ * @returns Log content and metadata
+ */
+export async function getLogs(agent, options = {}) {
+    const logsDir = options.logsDir ?? getDefaultLogsDir();
+    const lines = options.lines ?? 50;
+    const logFile = join(logsDir, `${agent}.log`);
+    try {
+        await stat(logFile);
+        const content = await tailFile(logFile, lines);
+        const lineCount = content ? content.split('\n').length : 0;
+        return {
+            agent,
+            content,
+            found: true,
+            lineCount,
+        };
+    }
+    catch {
+        return {
+            agent,
+            content: '',
+            found: false,
+            lineCount: 0,
+        };
+    }
+}
+/**
+ * List all agents that have log files.
+ *
+ * @example
+ * ```typescript
+ * import { listLoggedAgents } from '@agent-relay/sdk';
+ *
+ * const agents = await listLoggedAgents();
+ * console.log('Agents with logs:', agents);
+ * ```
+ *
+ * @param logsDir - Directory containing worker logs
+ * @returns Array of agent names
+ */
+export async function listLoggedAgents(logsDir) {
+    const dir = logsDir ?? getDefaultLogsDir();
+    try {
+        const files = await readdir(dir);
+        return files
+            .filter((f) => f.endsWith('.log'))
+            .map((f) => f.replace('.log', ''));
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=logs.js.map

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

@@ -1,6 +1,6 @@
 /**
  * Protocol exports for @agent-relay/sdk
  */
-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 MessageAttachment, type ChannelJoinPayload, type ChannelLeavePayload, type ChannelMessagePayload, 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, } from './types.js';
+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 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 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';
 //# sourceMappingURL=index.d.ts.map

package/packages/sdk/dist/protocol/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';
+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' | 'HEALTH' | 'HEALTH_RESPONSE' | 'METRICS' | 'METRICS_RESPONSE';
 export type PayloadKind = 'message' | 'action' | 'state' | 'thinking';
 /**
  * Base envelope structure for all protocol messages.
@@ -312,6 +312,181 @@ export interface ReleaseResultPayload {
     /** Error message (if failed) */
     error?: string;
 }
+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;
+}
+/**
+ * Payload for STATUS request.
+ */
+export interface StatusPayload {
+}
+/**
+ * Response payload for STATUS request.
+ */
+export interface StatusResponsePayload {
+    version?: string;
+    uptime?: number;
+    agentCount?: number;
+    messageCount?: number;
+}
+/**
+ * Payload for INBOX request.
+ */
+export interface InboxPayload {
+    agent: string;
+    limit?: number;
+    unreadOnly?: boolean;
+    from?: string;
+    channel?: string;
+}
+/**
+ * A stored message in the inbox.
+ */
+export interface InboxMessage {
+    id: string;
+    from: string;
+    body: string;
+    channel?: string;
+    thread?: string;
+    timestamp: number;
+}
+/**
+ * Response payload for INBOX request.
+ */
+export interface InboxResponsePayload {
+    messages: InboxMessage[];
+}
+/**
+ * Payload for LIST_AGENTS request.
+ */
+export interface ListAgentsPayload {
+    includeIdle?: boolean;
+    project?: string;
+}
+/**
+ * Agent info returned by LIST_AGENTS.
+ */
+export interface AgentInfo {
+    name: string;
+    cli?: string;
+    idle?: boolean;
+    parent?: string;
+    task?: string;
+    connectedAt?: number;
+}
+/**
+ * Response payload for LIST_AGENTS request.
+ */
+export interface ListAgentsResponsePayload {
+    agents: AgentInfo[];
+}
+/**
+ * Payload for HEALTH request.
+ */
+export interface HealthPayload {
+    includeCrashes?: boolean;
+    includeAlerts?: boolean;
+}
+/**
+ * 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;
+}
+/**
+ * Response payload for HEALTH request.
+ */
+export interface HealthResponsePayload {
+    healthScore: number;
+    summary: string;
+    issues: Array<{
+        severity: string;
+        message: string;
+    }>;
+    recommendations: string[];
+    crashes: CrashRecord[];
+    alerts: AlertRecord[];
+    stats: {
+        totalCrashes24h: number;
+        totalAlerts24h: number;
+        agentCount: number;
+    };
+}
+/**
+ * Payload for METRICS request.
+ */
+export interface MetricsPayload {
+    agent?: 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;
+}
+/**
+ * Response payload for METRICS request.
+ */
+export interface MetricsResponsePayload {
+    agents: AgentMetrics[];
+    system: {
+        totalMemory: number;
+        freeMemory: number;
+        heapUsed: number;
+    };
+}
 export type HelloEnvelope = Envelope<HelloPayload>;
 export type WelcomeEnvelope = Envelope<WelcomePayload>;
 export type SendEnvelope = Envelope<SendPayload> & {
@@ -338,4 +513,14 @@ export type ReleaseResultEnvelope = Envelope<ReleaseResultPayload>;
 export type ChannelJoinEnvelope = Envelope<ChannelJoinPayload>;
 export type ChannelLeaveEnvelope = Envelope<ChannelLeavePayload>;
 export type ChannelMessageEnvelope = Envelope<ChannelMessagePayload>;
+export type StatusEnvelope = Envelope<StatusPayload>;
+export type StatusResponseEnvelope = Envelope<StatusResponsePayload>;
+export type InboxEnvelope = Envelope<InboxPayload>;
+export type InboxResponseEnvelope = Envelope<InboxResponsePayload>;
+export type ListAgentsEnvelope = Envelope<ListAgentsPayload>;
+export type ListAgentsResponseEnvelope = Envelope<ListAgentsResponsePayload>;
+export type HealthEnvelope = Envelope<HealthPayload>;
+export type HealthResponseEnvelope = Envelope<HealthResponsePayload>;
+export type MetricsEnvelope = Envelope<MetricsPayload>;
+export type MetricsResponseEnvelope = Envelope<MetricsResponsePayload>;
 //# sourceMappingURL=types.d.ts.map

package/packages/sdk/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/sdk",
-  "version": "2.0.19",
+  "version": "2.0.21",
   "description": "Lightweight SDK for agent-to-agent communication via Agent Relay",
   "type": "module",
   "main": "dist/index.js",
@@ -45,7 +45,7 @@
     "sdk"
   ],
   "author": "Khaliq Gant",
-  "license": "MIT",
+  "license": "Apache-2.0",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/AgentWorkforce/relay.git",
@@ -55,7 +55,7 @@
     "access": "public"
   },
   "dependencies": {
-    "@agent-relay/protocol": "2.0.19"
+    "@agent-relay/protocol": "2.0.21"
   },
   "engines": {
     "node": ">=18.0.0"

package/packages/spawner/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/spawner",
-  "version": "2.0.19",
+  "version": "2.0.21",
   "description": "Agent spawning types and utilities for Agent Relay",
   "type": "module",
   "main": "dist/index.js",
@@ -43,5 +43,5 @@
     "url": "git+https://github.com/AgentWorkforce/relay.git",
     "directory": "packages/spawner"
   },
-  "license": "MIT"
+  "license": "Apache-2.0"
 }

package/packages/state/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/state",
-  "version": "2.0.19",
+  "version": "2.0.21",
   "description": "Agent state persistence for non-hook CLIs (Codex, Gemini, etc.)",
   "type": "module",
   "main": "dist/index.js",

package/packages/storage/dist/sqlite-adapter.js

@@ -67,6 +67,8 @@ export class SqliteStorageAdapter {
                 break;
             }
             catch (err) {
+                const msg = err instanceof Error ? err.message : String(err);
+                console.error(`[storage] SQLite driver "${driver}" failed: ${msg}`);
                 lastError = err;
             }
         }

package/packages/storage/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/storage",
-  "version": "2.0.19",
+  "version": "2.0.21",
   "description": "Storage adapters and interfaces for Relay message/session persistence",
   "type": "module",
   "main": "dist/index.js",
@@ -56,7 +56,7 @@
     }
   },
   "dependencies": {
-    "@agent-relay/protocol": "2.0.19"
+    "@agent-relay/protocol": "2.0.21"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/telemetry/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/telemetry",
-  "version": "2.0.19",
+  "version": "2.0.21",
   "description": "Anonymous telemetry for Agent Relay usage analytics",
   "type": "module",
   "main": "dist/index.js",

package/packages/trajectory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/trajectory",
-  "version": "2.0.19",
+  "version": "2.0.21",
   "description": "Trajectory integration utilities (trail/PDERO) for Relay",
   "type": "module",
   "main": "dist/index.js",
@@ -22,7 +22,7 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@agent-relay/config": "2.0.19"
+    "@agent-relay/config": "2.0.21"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/user-directory/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/user-directory",
-  "version": "2.0.19",
+  "version": "2.0.21",
   "description": "User directory service for agent-relay (per-user credential storage)",
   "type": "module",
   "main": "dist/index.js",
@@ -22,7 +22,7 @@
     "test:watch": "vitest"
   },
   "dependencies": {
-    "@agent-relay/resiliency": "2.0.19"
+    "@agent-relay/resiliency": "2.0.21"
   },
   "devDependencies": {
     "@types/node": "^22.19.3",

package/packages/utils/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/utils",
-  "version": "2.0.19",
+  "version": "2.0.21",
   "description": "Shared utilities for agent-relay: logging, name generation, command resolution, update checking",
   "type": "module",
   "main": "dist/index.js",

package/packages/wrapper/dist/base-wrapper.js

@@ -317,14 +317,7 @@ export class BaseWrapper extends EventEmitter {
             console.error(`[base-wrapper] Skipped duplicate message to ${cmd.to}`);
             return;
         }
-        this.sentMessageHashes.add(hash);
-        // Limit hash set size
-        if (this.sentMessageHashes.size > 500) {
-            const oldest = this.sentMessageHashes.values().next().value;
-            if (oldest)
-                this.sentMessageHashes.delete(oldest);
-        }
-        // Only send if client ready
+        // Only send if client ready - check BEFORE adding hash to avoid blocking retries
         if (this.client.state !== 'READY') {
             console.error(`[base-wrapper] Client not ready (state=${this.client.state}), dropping message to ${cmd.to}`);
             return;
@@ -338,14 +331,30 @@ export class BaseWrapper extends EventEmitter {
                 requires_ack: cmd.meta.ackRequired,
             };
         }
+        // Helper to mark message as sent (only after successful transmission)
+        const markSent = () => {
+            this.sentMessageHashes.add(hash);
+            // Limit hash set size
+            if (this.sentMessageHashes.size > 500) {
+                const oldest = this.sentMessageHashes.values().next().value;
+                if (oldest)
+                    this.sentMessageHashes.delete(oldest);
+            }
+        };
         // Check if target is a channel (starts with #)
         if (cmd.to.startsWith('#')) {
             // Use CHANNEL_MESSAGE protocol for channel targets
             console.error(`[base-wrapper] Sending CHANNEL_MESSAGE to ${cmd.to}`);
-            this.client.sendChannelMessage(cmd.to, cmd.body, {
+            const success = this.client.sendChannelMessage(cmd.to, cmd.body, {
                 thread: cmd.thread,
                 data: cmd.data,
             });
+            if (success) {
+                markSent();
+            }
+            else {
+                console.error(`[base-wrapper] sendChannelMessage failed for ${cmd.to}`);
+            }
         }
         else {
             // Use SEND protocol for direct messages and broadcasts
@@ -355,12 +364,20 @@ export class BaseWrapper extends EventEmitter {
                     kind: cmd.kind,
                     data: cmd.data,
                     thread: cmd.thread,
+                }).then(() => {
+                    markSent();
                 }).catch((err) => {
                     console.error(`[base-wrapper] sendAndWait failed for ${cmd.to}: ${err.message}`);
                 });
             }
             else {
-                this.client.sendMessage(cmd.to, cmd.body, cmd.kind, cmd.data, cmd.thread, sendMeta);
+                const success = this.client.sendMessage(cmd.to, cmd.body, cmd.kind, cmd.data, cmd.thread, sendMeta);
+                if (success) {
+                    markSent();
+                }
+                else {
+                    console.error(`[base-wrapper] sendMessage failed for ${cmd.to}`);
+                }
             }
         }
     }

package/packages/wrapper/dist/relay-pty-orchestrator.js

@@ -19,6 +19,7 @@ import { spawn } from 'node:child_process';
 import { createConnection } from 'node:net';
 import { createHash } from 'node:crypto';
 import { join, dirname } from 'node:path';
+import { homedir } from 'node:os';
 import { existsSync, unlinkSync, mkdirSync, symlinkSync, lstatSync, rmSync, watch, readdirSync, readlinkSync, writeFileSync, appendFileSync } from 'node:fs';
 import { getProjectPaths } from '@agent-relay/config/project-namespace';
 import { fileURLToPath } from 'node:url';
@@ -140,17 +141,12 @@ export class RelayPtyOrchestrator extends BaseWrapper {
             this._legacyOutboxPath = `/tmp/relay-outbox/${config.name}`;
         }
         else {
-            // Local mode: use ~/.agent-relay paths directly (no symlinks needed)
+            // Local mode: use project paths directly (no symlinks needed)
             this._outboxPath = this._canonicalOutboxPath;
-            // Socket at {projectRoot}/.agent-relay/sockets/{agentName}.sock
-            let localSocketPath = join(projectPaths.dataDir, 'sockets', `${config.name}.sock`);
-            // If socket path is too long, fall back to /tmp/relay-local/{projectId}/sockets/
-            if (localSocketPath.length > MAX_SOCKET_PATH_LENGTH) {
-                const tmpSocketPath = `/tmp/relay-local/${projectPaths.projectId}/sockets/${config.name}.sock`;
-                console.warn(`[relay-pty-orchestrator:${config.name}] Socket path too long (${localSocketPath.length} chars); using /tmp fallback`);
-                localSocketPath = tmpSocketPath;
-            }
-            this.socketPath = localSocketPath;
+            // Socket path: use ~/.agent-relay/sockets/{projectId}/{agentName}.sock
+            // This keeps paths short (uses 12-char hashed projectId) while staying organized
+            // Example: /Users/foo/.agent-relay/sockets/abc123def456/MyAgent.sock (~65 chars)
+            this.socketPath = join(homedir(), '.agent-relay', 'sockets', projectPaths.projectId, `${config.name}.sock`);
             // Legacy path for backwards compat (older agents might still use /tmp/relay-outbox)
             // Even in local mode, we need this symlink for agents with stale instructions
             this._legacyOutboxPath = `/tmp/relay-outbox/${config.name}`;
@@ -385,7 +381,13 @@ export class RelayPtyOrchestrator extends BaseWrapper {
             throw new Error('relay-pty binary not found. Build with: cd relay-pty && cargo build --release');
         }
         this.log(` Using binary: ${binaryPath}`);
-        // Connect to relay daemon first
+        // Spawn relay-pty process FIRST (before connecting to daemon)
+        // This ensures the CLI is actually running before we register with the daemon
+        await this.spawnRelayPty(binaryPath);
+        // Wait for socket to become available and connect
+        await this.connectToSocket();
+        // Connect to relay daemon AFTER CLI is spawned
+        // This prevents the spawner from seeing us as "registered" before the CLI runs
         try {
             await this.client.connect();
             this.log(` Relay daemon connected`);
@@ -393,10 +395,6 @@ export class RelayPtyOrchestrator extends BaseWrapper {
         catch (err) {
             this.logError(` Relay connect failed: ${err.message}`);
         }
-        // Spawn relay-pty process
-        await this.spawnRelayPty(binaryPath);
-        // Wait for socket to become available and connect
-        await this.connectToSocket();
         this.running = true;
         // DON'T set readyForMessages yet - wait for CLI to be ready first
         // This prevents messages from being injected during CLI startup
@@ -649,7 +647,9 @@ export class RelayPtyOrchestrator extends BaseWrapper {
         // Wait for process to start
         await sleep(500);
         if (proc.exitCode !== null) {
-            throw new Error(`relay-pty exited immediately with code ${proc.exitCode}`);
+            // Include any captured stderr in the error for debugging
+            const stderrInfo = stderrBuffer ? `\nStderr: ${stderrBuffer.slice(0, 500)}` : '';
+            throw new Error(`relay-pty exited immediately with code ${proc.exitCode}${stderrInfo}`);
         }
         // Register for memory/CPU monitoring
         if (proc.pid) {

package/packages/wrapper/dist/tmux-wrapper.js

@@ -805,6 +805,22 @@ export class TmuxWrapper extends BaseWrapper {
                 requires_ack: cmd.meta.ackRequired,
             };
         }
+        // Check if target is a channel (starts with #)
+        if (cmd.to.startsWith('#')) {
+            // Use CHANNEL_MESSAGE protocol for channel targets
+            this.logStderr(`→ [channel] ${cmd.to}: ${cmd.body.substring(0, Math.min(RELAY_LOG_TRUNCATE_LENGTH, cmd.body.length))}...`);
+            const success = this.client.sendChannelMessage(cmd.to, cmd.body, {
+                thread: cmd.thread,
+                data: cmd.data,
+            });
+            if (success) {
+                this.sentMessageHashes.add(msgHash);
+                this.queuedMessageHashes.delete(msgHash);
+                this.trajectory?.message('sent', this.config.name, cmd.to, cmd.body);
+            }
+            return;
+        }
+        // Use SEND protocol for direct messages and broadcasts
         if (cmd.sync?.blocking) {
             this.client.sendAndWait(cmd.to, cmd.body, {
                 timeoutMs: cmd.sync.timeoutMs,

package/packages/wrapper/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-relay/wrapper",
-  "version": "2.0.19",
+  "version": "2.0.21",
   "description": "CLI agent wrappers for Agent Relay - tmux, pty integration",
   "type": "module",
   "main": "dist/index.js",
@@ -30,11 +30,11 @@
     "clean": "rm -rf dist"
   },
   "dependencies": {
-    "@agent-relay/api-types": "2.0.19",
-    "@agent-relay/protocol": "2.0.19",
-    "@agent-relay/config": "2.0.19",
-    "@agent-relay/continuity": "2.0.19",
-    "@agent-relay/resiliency": "2.0.19"
+    "@agent-relay/api-types": "2.0.21",
+    "@agent-relay/protocol": "2.0.21",
+    "@agent-relay/config": "2.0.21",
+    "@agent-relay/continuity": "2.0.21",
+    "@agent-relay/resiliency": "2.0.21"
   },
   "devDependencies": {
     "typescript": "^5.9.3",
@@ -59,5 +59,5 @@
     "url": "git+https://github.com/AgentWorkforce/relay.git",
     "directory": "packages/wrapper"
   },
-  "license": "MIT"
+  "license": "Apache-2.0"
 }

package/scripts/hooks/install.sh

@@ -0,0 +1,16 @@
+#!/bin/sh
+# Install git hooks for agent-relay
+# Usage: ./scripts/hooks/install.sh
+
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+REPO_ROOT="$(cd "$SCRIPT_DIR/../.." && pwd)"
+HOOKS_DIR="$REPO_ROOT/.git/hooks"
+
+echo "Installing git hooks..."
+
+# Install pre-commit hook
+cp "$SCRIPT_DIR/pre-commit" "$HOOKS_DIR/pre-commit"
+chmod +x "$HOOKS_DIR/pre-commit"
+echo "  Installed pre-commit hook"
+
+echo "Done! Git hooks installed."