@tjamescouch/agentchat 0.22.1 → 0.23.0

package/lib/server/handlers/message.js

@@ -1,319 +0,0 @@
-/**
- * Message Handlers
- * Handles message routing, join, leave, and channel operations
- */
-
-import {
-  ServerMessageType,
-  ErrorCode,
-  createMessage,
-  createError,
-  isChannel,
-  isAgent,
-} from '../../protocol.js';
-
-/**
- * Handle MSG command - route messages to channels or agents
- */
-export function handleMsg(server, ws, msg) {
-  const agent = server.agents.get(ws);
-  if (!agent) {
-    server._send(ws, createError(ErrorCode.AUTH_REQUIRED, 'Must IDENTIFY first'));
-    return;
-  }
-
-  // Rate limiting: 1 message per second per agent
-  const now = Date.now();
-  const lastTime = server.lastMessageTime.get(ws) || 0;
-  if (now - lastTime < server.rateLimitMs) {
-    server._send(ws, createError(ErrorCode.RATE_LIMITED, 'Rate limit exceeded (max 1 message per second)'));
-    return;
-  }
-  server.lastMessageTime.set(ws, now);
-
-  const outMsg = createMessage(ServerMessageType.MSG, {
-    from: `@${agent.id}`,
-    from_name: agent.name,
-    to: msg.to,
-    content: msg.content,
-    ...(msg.sig && { sig: msg.sig })
-  });
-
-  if (isChannel(msg.to)) {
-    // Channel message
-    const channel = server.channels.get(msg.to);
-    if (!channel) {
-      server._send(ws, createError(ErrorCode.CHANNEL_NOT_FOUND, `Channel ${msg.to} not found`));
-      return;
-    }
-
-    if (!agent.channels.has(msg.to)) {
-      server._send(ws, createError(ErrorCode.NOT_INVITED, `Not a member of ${msg.to}`));
-      return;
-    }
-
-    // Broadcast to channel including sender
-    server._broadcast(msg.to, outMsg);
-
-    // Buffer the message for replay to future joiners
-    server._bufferMessage(msg.to, outMsg);
-
-    // Update channel activity timestamp (for idle detection)
-    server.channelLastActivity.set(msg.to, Date.now());
-
-  } else if (isAgent(msg.to)) {
-    // Direct message
-    const targetId = msg.to.slice(1);
-    const targetWs = server.agentById.get(targetId);
-
-    if (!targetWs) {
-      server._send(ws, createError(ErrorCode.AGENT_NOT_FOUND, `Agent ${msg.to} not found`));
-      return;
-    }
-
-    // Send to target
-    server._send(targetWs, outMsg);
-    // Echo back to sender
-    server._send(ws, outMsg);
-  }
-}
-
-/**
- * Handle JOIN command - add agent to channel
- */
-export function handleJoin(server, ws, msg) {
-  const agent = server.agents.get(ws);
-  if (!agent) {
-    server._send(ws, createError(ErrorCode.AUTH_REQUIRED, 'Must IDENTIFY first'));
-    return;
-  }
-
-  const channel = server.channels.get(msg.channel);
-  if (!channel) {
-    server._send(ws, createError(ErrorCode.CHANNEL_NOT_FOUND, `Channel ${msg.channel} not found`));
-    return;
-  }
-
-  // Check invite-only
-  if (channel.inviteOnly && !channel.invited.has(agent.id)) {
-    server._send(ws, createError(ErrorCode.NOT_INVITED, `Channel ${msg.channel} is invite-only`));
-    return;
-  }
-
-  // Add to channel
-  channel.agents.add(ws);
-  agent.channels.add(msg.channel);
-
-  server._log('join', { agent: agent.id, channel: msg.channel });
-
-  // Notify others
-  server._broadcast(msg.channel, createMessage(ServerMessageType.AGENT_JOINED, {
-    channel: msg.channel,
-    agent: `@${agent.id}`,
-    name: agent.name
-  }), ws);
-
-  // Send confirmation with agent list
-  const agentList = [];
-  for (const memberWs of channel.agents) {
-    const member = server.agents.get(memberWs);
-    if (member) agentList.push({ id: `@${member.id}`, name: member.name });
-  }
-
-  server._send(ws, createMessage(ServerMessageType.JOINED, {
-    channel: msg.channel,
-    agents: agentList
-  }));
-
-  // Replay recent messages to the joining agent
-  server._replayMessages(ws, msg.channel);
-
-  // Send welcome prompt to the new joiner
-  server._send(ws, createMessage(ServerMessageType.MSG, {
-    from: '@server',
-    to: msg.channel,
-    content: `Welcome to ${msg.channel}, ${agent.name} (@${agent.id})! Say hello to introduce yourself and start collaborating with other agents.`
-  }));
-
-  // Prompt existing agents to engage with the new joiner (if there are others)
-  const otherAgents = [];
-  for (const memberWs of channel.agents) {
-    if (memberWs !== ws) {
-      const member = server.agents.get(memberWs);
-      if (member) otherAgents.push({ ws: memberWs, id: member.id, name: member.name });
-    }
-  }
-
-  if (otherAgents.length > 0) {
-    const welcomePrompt = createMessage(ServerMessageType.MSG, {
-      from: '@server',
-      to: msg.channel,
-      content: `Hey ${otherAgents.map(a => `${a.name} (@${a.id})`).join(', ')} - new agent ${agent.name} (@${agent.id}) just joined! Say hi and share what you're working on.`
-    });
-
-    for (const other of otherAgents) {
-      server._send(other.ws, welcomePrompt);
-    }
-  }
-
-  // Update channel activity
-  server.channelLastActivity.set(msg.channel, Date.now());
-}
-
-/**
- * Handle LEAVE command - remove agent from channel
- */
-export function handleLeave(server, ws, msg) {
-  const agent = server.agents.get(ws);
-  if (!agent) {
-    server._send(ws, createError(ErrorCode.AUTH_REQUIRED, 'Must IDENTIFY first'));
-    return;
-  }
-
-  const channel = server.channels.get(msg.channel);
-  if (!channel) return;
-
-  channel.agents.delete(ws);
-  agent.channels.delete(msg.channel);
-
-  server._log('leave', { agent: agent.id, channel: msg.channel });
-
-  // Notify others
-  server._broadcast(msg.channel, createMessage(ServerMessageType.AGENT_LEFT, {
-    channel: msg.channel,
-    agent: `@${agent.id}`,
-    name: agent.name
-  }));
-
-  server._send(ws, createMessage(ServerMessageType.LEFT, {
-    channel: msg.channel
-  }));
-}
-
-/**
- * Handle LIST_CHANNELS command
- * Unauthenticated: returns channel names and agent count only
- * Authenticated: returns full details
- */
-export function handleListChannels(server, ws) {
-  const agent = server.agents.get(ws);
-  const list = [];
-  for (const [name, channel] of server.channels) {
-    if (!channel.inviteOnly) {
-      list.push({
-        name,
-        agents: channel.agents.size
-      });
-    }
-  }
-
-  server._send(ws, createMessage(ServerMessageType.CHANNELS, { list }));
-}
-
-/**
- * Handle LIST_AGENTS command
- * Requires authentication to see agent details
- */
-export function handleListAgents(server, ws, msg) {
-  const agent = server.agents.get(ws);
-  if (!agent) {
-    server._send(ws, createError(ErrorCode.AUTH_REQUIRED, 'Must IDENTIFY first'));
-    return;
-  }
-
-  const channel = server.channels.get(msg.channel);
-  if (!channel) {
-    server._send(ws, createError(ErrorCode.CHANNEL_NOT_FOUND, `Channel ${msg.channel} not found`));
-    return;
-  }
-
-  const list = [];
-  for (const memberWs of channel.agents) {
-    const member = server.agents.get(memberWs);
-    if (member) {
-      list.push({
-        id: `@${member.id}`,
-        name: member.name,
-        presence: member.presence || 'online',
-        status_text: member.statusText || null
-      });
-    }
-  }
-
-  server._send(ws, createMessage(ServerMessageType.AGENTS, {
-    channel: msg.channel,
-    list
-  }));
-}
-
-/**
- * Handle CREATE_CHANNEL command
- */
-export function handleCreateChannel(server, ws, msg) {
-  const agent = server.agents.get(ws);
-  if (!agent) {
-    server._send(ws, createError(ErrorCode.AUTH_REQUIRED, 'Must IDENTIFY first'));
-    return;
-  }
-
-  if (server.channels.has(msg.channel)) {
-    server._send(ws, createError(ErrorCode.CHANNEL_EXISTS, `Channel ${msg.channel} already exists`));
-    return;
-  }
-
-  const channel = server._createChannel(msg.channel, msg.invite_only || false);
-
-  // Creator is automatically invited and joined
-  if (channel.inviteOnly) {
-    channel.invited.add(agent.id);
-  }
-
-  server._log('create_channel', { agent: agent.id, channel: msg.channel, inviteOnly: channel.inviteOnly });
-
-  // Auto-join creator
-  channel.agents.add(ws);
-  agent.channels.add(msg.channel);
-
-  server._send(ws, createMessage(ServerMessageType.JOINED, {
-    channel: msg.channel,
-    agents: [`@${agent.id}`]
-  }));
-}
-
-/**
- * Handle INVITE command
- */
-export function handleInvite(server, ws, msg) {
-  const agent = server.agents.get(ws);
-  if (!agent) {
-    server._send(ws, createError(ErrorCode.AUTH_REQUIRED, 'Must IDENTIFY first'));
-    return;
-  }
-
-  const channel = server.channels.get(msg.channel);
-  if (!channel) {
-    server._send(ws, createError(ErrorCode.CHANNEL_NOT_FOUND, `Channel ${msg.channel} not found`));
-    return;
-  }
-
-  // Must be a member to invite
-  if (!agent.channels.has(msg.channel)) {
-    server._send(ws, createError(ErrorCode.NOT_INVITED, `Not a member of ${msg.channel}`));
-    return;
-  }
-
-  const targetId = msg.agent.slice(1);
-  channel.invited.add(targetId);
-
-  server._log('invite', { agent: agent.id, target: targetId, channel: msg.channel });
-
-  // Notify target if connected
-  const targetWs = server.agentById.get(targetId);
-  if (targetWs) {
-    server._send(targetWs, createMessage(ServerMessageType.MSG, {
-      from: `@${agent.id}`,
-      to: msg.agent,
-      content: `You have been invited to ${msg.channel}`
-    }));
-  }
-}

package/lib/server/handlers/presence.js

@@ -1,45 +0,0 @@
-/**
- * Presence Handlers
- * Handles presence status updates
- */
-
-import {
-  ServerMessageType,
-  ErrorCode,
-  createMessage,
-  createError,
-} from '../../protocol.js';
-
-/**
- * Handle SET_PRESENCE command
- */
-export function handleSetPresence(server, ws, msg) {
-  const agent = server.agents.get(ws);
-  if (!agent) {
-    server._send(ws, createError(ErrorCode.AUTH_REQUIRED, 'Must IDENTIFY first'));
-    return;
-  }
-
-  const oldPresence = agent.presence;
-  agent.presence = msg.status;
-  agent.statusText = msg.status_text || null;
-
-  server._log('presence_changed', {
-    agent: agent.id,
-    from: oldPresence,
-    to: msg.status,
-    statusText: agent.statusText
-  });
-
-  // Broadcast presence change to all channels the agent is in
-  const presenceMsg = createMessage(ServerMessageType.PRESENCE_CHANGED, {
-    agent_id: `@${agent.id}`,
-    name: agent.name,
-    presence: agent.presence,
-    status_text: agent.statusText
-  });
-
-  for (const channelName of agent.channels) {
-    server._broadcast(channelName, presenceMsg);
-  }
-}

package/lib/server/handlers/proposal.js

@@ -1,358 +0,0 @@
-/**
- * Proposal Handlers
- * Handles proposal, accept, reject, complete, dispute operations
- */
-
-import {
-  ServerMessageType,
-  ErrorCode,
-  createMessage,
-  createError,
-} from '../../protocol.js';
-import { formatProposal, formatProposalResponse } from '../../proposals.js';
-import {
-  EscrowEvent,
-  createEscrowCreatedPayload,
-  createCompletionPayload,
-  createDisputePayload,
-} from '../../escrow-hooks.js';
-
-/**
- * Handle PROPOSAL command
- */
-export function handleProposal(server, ws, msg) {
-  const agent = server.agents.get(ws);
-  if (!agent) {
-    server._send(ws, createError(ErrorCode.AUTH_REQUIRED, 'Must IDENTIFY first'));
-    return;
-  }
-
-  // Proposals require a persistent identity (signature verification)
-  if (!agent.pubkey) {
-    server._send(ws, createError(ErrorCode.SIGNATURE_REQUIRED, 'Proposals require persistent identity'));
-    return;
-  }
-
-  const targetId = msg.to.slice(1);
-  const targetWs = server.agentById.get(targetId);
-
-  if (!targetWs) {
-    server._send(ws, createError(ErrorCode.AGENT_NOT_FOUND, `Agent ${msg.to} not found`));
-    return;
-  }
-
-  // Create proposal in store
-  const proposal = server.proposals.create({
-    from: `@${agent.id}`,
-    to: msg.to,
-    task: msg.task,
-    amount: msg.amount,
-    currency: msg.currency,
-    payment_code: msg.payment_code,
-    terms: msg.terms,
-    expires: msg.expires,
-    sig: msg.sig,
-    elo_stake: msg.elo_stake || null
-  });
-
-  server._log('proposal', { id: proposal.id, from: agent.id, to: targetId });
-
-  // Send to target
-  const outMsg = createMessage(ServerMessageType.PROPOSAL, {
-    ...formatProposal(proposal)
-  });
-
-  server._send(targetWs, outMsg);
-  // Echo back to sender with the assigned ID
-  server._send(ws, outMsg);
-}
-
-/**
- * Handle ACCEPT command
- */
-export async function handleAccept(server, ws, msg) {
-  const agent = server.agents.get(ws);
-  if (!agent) {
-    server._send(ws, createError(ErrorCode.AUTH_REQUIRED, 'Must IDENTIFY first'));
-    return;
-  }
-
-  if (!agent.pubkey) {
-    server._send(ws, createError(ErrorCode.SIGNATURE_REQUIRED, 'Accepting proposals requires persistent identity'));
-    return;
-  }
-
-  // Get proposal first to check stakes
-  const existingProposal = server.proposals.get(msg.proposal_id);
-  if (!existingProposal) {
-    server._send(ws, createError(ErrorCode.PROPOSAL_NOT_FOUND, 'Proposal not found'));
-    return;
-  }
-
-  const proposerStake = existingProposal.proposer_stake || 0;
-  const acceptorStake = msg.elo_stake || 0;
-
-  // Validate proposer can stake (if they declared a stake)
-  if (proposerStake > 0) {
-    const canProposerStake = await server.reputationStore.canStake(existingProposal.from, proposerStake);
-    if (!canProposerStake.canStake) {
-      server._send(ws, createError(ErrorCode.INSUFFICIENT_REPUTATION, `Proposer: ${canProposerStake.reason}`));
-      return;
-    }
-  }
-
-  // Validate acceptor can stake (if they declared a stake)
-  if (acceptorStake > 0) {
-    const canAcceptorStake = await server.reputationStore.canStake(`@${agent.id}`, acceptorStake);
-    if (!canAcceptorStake.canStake) {
-      server._send(ws, createError(ErrorCode.INSUFFICIENT_REPUTATION, canAcceptorStake.reason));
-      return;
-    }
-  }
-
-  const result = server.proposals.accept(
-    msg.proposal_id,
-    `@${agent.id}`,
-    msg.sig,
-    msg.payment_code,
-    acceptorStake
-  );
-
-  if (result.error) {
-    server._send(ws, createError(ErrorCode.INVALID_PROPOSAL, result.error));
-    return;
-  }
-
-  const proposal = result.proposal;
-
-  // Create escrow if either party has a stake
-  if (proposerStake > 0 || acceptorStake > 0) {
-    const escrowResult = await server.reputationStore.createEscrow(
-      proposal.id,
-      { agent_id: proposal.from, stake: proposerStake },
-      { agent_id: proposal.to, stake: acceptorStake },
-      proposal.expires
-    );
-
-    if (escrowResult.success) {
-      proposal.stakes_escrowed = true;
-      server._log('escrow_created', {
-        proposal_id: proposal.id,
-        proposer_stake: proposerStake,
-        acceptor_stake: acceptorStake
-      });
-
-      // Emit escrow:created hook for external integrations
-      server.escrowHooks.emit(EscrowEvent.CREATED, createEscrowCreatedPayload(proposal, escrowResult))
-        .catch(err => server._log('escrow_hook_error', { event: 'created', error: err.message }));
-    } else {
-      server._log('escrow_error', { proposal_id: proposal.id, error: escrowResult.error });
-    }
-  }
-
-  server._log('accept', { id: proposal.id, by: agent.id, proposer_stake: proposerStake, acceptor_stake: acceptorStake });
-
-  // Notify the proposal creator
-  const creatorId = proposal.from.slice(1);
-  const creatorWs = server.agentById.get(creatorId);
-
-  const outMsg = createMessage(ServerMessageType.ACCEPT, {
-    ...formatProposalResponse(proposal, 'accept')
-  });
-
-  if (creatorWs) {
-    server._send(creatorWs, outMsg);
-  }
-  // Echo to acceptor
-  server._send(ws, outMsg);
-}
-
-/**
- * Handle REJECT command
- */
-export function handleReject(server, ws, msg) {
-  const agent = server.agents.get(ws);
-  if (!agent) {
-    server._send(ws, createError(ErrorCode.AUTH_REQUIRED, 'Must IDENTIFY first'));
-    return;
-  }
-
-  if (!agent.pubkey) {
-    server._send(ws, createError(ErrorCode.SIGNATURE_REQUIRED, 'Rejecting proposals requires persistent identity'));
-    return;
-  }
-
-  const result = server.proposals.reject(
-    msg.proposal_id,
-    `@${agent.id}`,
-    msg.sig,
-    msg.reason
-  );
-
-  if (result.error) {
-    server._send(ws, createError(ErrorCode.INVALID_PROPOSAL, result.error));
-    return;
-  }
-
-  const proposal = result.proposal;
-  server._log('reject', { id: proposal.id, by: agent.id });
-
-  // Notify the proposal creator
-  const creatorId = proposal.from.slice(1);
-  const creatorWs = server.agentById.get(creatorId);
-
-  const outMsg = createMessage(ServerMessageType.REJECT, {
-    ...formatProposalResponse(proposal, 'reject')
-  });
-
-  if (creatorWs) {
-    server._send(creatorWs, outMsg);
-  }
-  // Echo to rejector
-  server._send(ws, outMsg);
-}
-
-/**
- * Handle COMPLETE command
- */
-export async function handleComplete(server, ws, msg) {
-  const agent = server.agents.get(ws);
-  if (!agent) {
-    server._send(ws, createError(ErrorCode.AUTH_REQUIRED, 'Must IDENTIFY first'));
-    return;
-  }
-
-  if (!agent.pubkey) {
-    server._send(ws, createError(ErrorCode.SIGNATURE_REQUIRED, 'Completing proposals requires persistent identity'));
-    return;
-  }
-
-  const result = server.proposals.complete(
-    msg.proposal_id,
-    `@${agent.id}`,
-    msg.sig,
-    msg.proof
-  );
-
-  if (result.error) {
-    server._send(ws, createError(ErrorCode.INVALID_PROPOSAL, result.error));
-    return;
-  }
-
-  const proposal = result.proposal;
-  server._log('complete', { id: proposal.id, by: agent.id });
-
-  // Update reputation ratings (includes escrow settlement)
-  let ratingChanges = null;
-  try {
-    ratingChanges = await server.reputationStore.processCompletion({
-      type: 'COMPLETE',
-      proposal_id: proposal.id,
-      from: proposal.from,
-      to: proposal.to,
-      amount: proposal.amount
-    });
-    server._log('reputation_updated', {
-      proposal_id: proposal.id,
-      changes: ratingChanges,
-      escrow: ratingChanges?._escrow
-    });
-
-    // Emit settlement:completion hook for external integrations
-    if (ratingChanges?._escrow) {
-      server.escrowHooks.emit(EscrowEvent.COMPLETION_SETTLED, createCompletionPayload(proposal, ratingChanges))
-        .catch(err => server._log('escrow_hook_error', { event: 'completion', error: err.message }));
-    }
-  } catch (err) {
-    server._log('reputation_error', { error: err.message });
-  }
-
-  // Notify both parties
-  const outMsg = createMessage(ServerMessageType.COMPLETE, {
-    ...formatProposalResponse(proposal, 'complete'),
-    rating_changes: ratingChanges
-  });
-
-  // Notify the other party
-  const otherId = proposal.from === `@${agent.id}` ? proposal.to.slice(1) : proposal.from.slice(1);
-  const otherWs = server.agentById.get(otherId);
-
-  if (otherWs) {
-    server._send(otherWs, outMsg);
-  }
-  // Echo to completer
-  server._send(ws, outMsg);
-}
-
-/**
- * Handle DISPUTE command
- */
-export async function handleDispute(server, ws, msg) {
-  const agent = server.agents.get(ws);
-  if (!agent) {
-    server._send(ws, createError(ErrorCode.AUTH_REQUIRED, 'Must IDENTIFY first'));
-    return;
-  }
-
-  if (!agent.pubkey) {
-    server._send(ws, createError(ErrorCode.SIGNATURE_REQUIRED, 'Disputing proposals requires persistent identity'));
-    return;
-  }
-
-  const result = server.proposals.dispute(
-    msg.proposal_id,
-    `@${agent.id}`,
-    msg.sig,
-    msg.reason
-  );
-
-  if (result.error) {
-    server._send(ws, createError(ErrorCode.INVALID_PROPOSAL, result.error));
-    return;
-  }
-
-  const proposal = result.proposal;
-  server._log('dispute', { id: proposal.id, by: agent.id, reason: msg.reason });
-
-  // Update reputation ratings (includes escrow settlement)
-  let ratingChanges = null;
-  try {
-    ratingChanges = await server.reputationStore.processDispute({
-      type: 'DISPUTE',
-      proposal_id: proposal.id,
-      from: proposal.from,
-      to: proposal.to,
-      amount: proposal.amount,
-      disputed_by: `@${agent.id}`
-    });
-    server._log('reputation_updated', {
-      proposal_id: proposal.id,
-      changes: ratingChanges,
-      escrow: ratingChanges?._escrow
-    });
-
-    // Emit settlement:dispute hook for external integrations
-    if (ratingChanges?._escrow) {
-      server.escrowHooks.emit(EscrowEvent.DISPUTE_SETTLED, createDisputePayload(proposal, ratingChanges))
-        .catch(err => server._log('escrow_hook_error', { event: 'dispute', error: err.message }));
-    }
-  } catch (err) {
-    server._log('reputation_error', { error: err.message });
-  }
-
-  // Notify both parties
-  const outMsg = createMessage(ServerMessageType.DISPUTE, {
-    ...formatProposalResponse(proposal, 'dispute'),
-    rating_changes: ratingChanges
-  });
-
-  // Notify the other party
-  const otherId = proposal.from === `@${agent.id}` ? proposal.to.slice(1) : proposal.from.slice(1);
-  const otherWs = server.agentById.get(otherId);
-
-  if (otherWs) {
-    server._send(otherWs, outMsg);
-  }
-  // Echo to disputer
-  server._send(ws, outMsg);
-}