Files
skillkit/packages/messaging
Rohit Ghumare 145bf80342 chore: bump to 1.23.0, rewrite README, drop dead LLM SDK deps, add branded tags
Version bump
------------
1.22.1 -> 1.23.0 across all workspace packages. Minor bump covers the
slim-install dependency layout, safer first-time agent picker, and the
corresponding doc + branding changes.

Prune dead optional deps in @skillkit/core
------------------------------------------
@anthropic-ai/sdk, @google/genai, ollama, and openai were listed as
optionalDependencies but never imported. They were pulled through
@skillkit/cli transitively on every default install, adding ~57
packages and one deprecation warning (node-domexception via the
SDKs' own formdata-node / node-fetch transitives). Grep of
packages/core/src confirms no SDK import; providers in
src/ai/providers use direct fetch() against the provider HTTP APIs.
Drop them. better-sqlite3, sqlite-vec, and node-llama-cpp stay
because they are actually dynamic-imported by the vector store and
embedding pipeline.

Measured on a fresh npm cache (overrides-pinned file: tarballs):
  before:   475 pkgs / 18s / 3 deprecation warnings
  1.23.0:   418 pkgs / 18s / 2 deprecation warnings
  slim:     118 pkgs /  9s / 0 deprecation warnings
The two remaining warnings are upstream:
  - prebuild-install@7.1.3 from better-sqlite3 (must stay)
  - glob@9.3.5 from @opentui/solid -> babel-plugin-module-resolver

README rewrite
--------------
Punchier top fold. Palette-consistent SVG tag badges under
assets/tags/ replace most shields.io badges (still keep npm/CI/etc
on shields since they need live data). Collapsible detail blocks
for every feature instead of the linear wall. Same nav anchors the
site uses. No em dashes. No AI filler words. Writing style pulls
from the ai-engineering-from-scratch and awesome-claude-design
READMEs the user already runs.

Branded SVG tags
----------------
scripts/gen-tags.mjs generates 20 SVG pills under assets/tags/ in
the SkillKit palette (#09090b base, #fafafa text, #3f3f46 border,
accent per tag). Two variants: single pill with left accent bar
(new, slim-install, v1.23.0, etc.) and split badge (agents | 45,
packages | 118, install | 9s). Matches the aesthetic used on
awesome-claude-design, tailored to SkillKit's monochrome brand.
The tags directory is fork-and-remix friendly; README points to it.
2026-04-21 00:11:44 +01:00
..

@skillkit/messaging

npm version License

Inter-agent messaging for SkillKit - Asynchronous communication between AI agents across the mesh network.

Installation

npm install @skillkit/messaging

Key Features

  • Agent-to-Agent Messaging: Send messages between AI coding agents
  • Inbox/Outbox Pattern: Persistent message storage with read tracking
  • Message Threading: Reply chains and conversation threads
  • Priority Levels: Urgent, normal, and low priority messages
  • Mesh Integration: Built on @skillkit/mesh for secure delivery
  • Offline Queuing: Messages queued when recipient offline
  • Message Archiving: Archive old messages for reference

Usage

Initialize Messaging

import { MessagingClient } from '@skillkit/messaging';
import { MeshHost } from '@skillkit/mesh';

// Create messaging client (requires mesh host)
const messaging = new MessagingClient({
  meshHost: host,
  storagePath: '~/.skillkit/messages',
});

await messaging.init();

Send Messages

// Send a message to another agent
await messaging.send({
  to: 'claude@laptop',
  subject: 'Code review completed',
  body: 'I reviewed the authentication module. See attached suggestions.',
  priority: 'normal',
  attachments: [{ type: 'diff', content: '...' }],
});

// Reply to a message
await messaging.reply(messageId, {
  body: 'Thanks! I will apply the suggestions.',
});

Read Inbox

// Get inbox messages
const inbox = await messaging.getInbox({
  unreadOnly: false,
  limit: 20,
});

// Get unread count
const unreadCount = await messaging.getUnreadCount();

// Read a specific message
const message = await messaging.read(messageId);

// Mark as read
await messaging.markAsRead(messageId);

Message Management

// Archive a message
await messaging.archive(messageId);

// Get sent messages
const sent = await messaging.getSent({ limit: 10 });

// Delete a message
await messaging.delete(messageId);

// Search messages
const results = await messaging.search('authentication');

Event Handling

// Listen for new messages
messaging.on('message', (msg) => {
  console.log('New message from:', msg.from);
  console.log('Subject:', msg.subject);
});

// Listen for delivery confirmations
messaging.on('delivered', (msgId) => {
  console.log('Message delivered:', msgId);
});

API Reference

MessagingClient

interface MessagingClient {
  init(): Promise<void>;
  send(message: OutgoingMessage): Promise<string>;
  reply(messageId: string, reply: ReplyMessage): Promise<string>;
  getInbox(options?: InboxOptions): Promise<Message[]>;
  getSent(options?: SentOptions): Promise<Message[]>;
  read(messageId: string): Promise<Message>;
  markAsRead(messageId: string): Promise<void>;
  archive(messageId: string): Promise<void>;
  delete(messageId: string): Promise<void>;
  search(query: string): Promise<Message[]>;
  getUnreadCount(): Promise<number>;
  on(event: 'message' | 'delivered' | 'error', handler: Function): void;
  close(): Promise<void>;
}

Types

interface Message {
  id: string;
  from: string;
  to: string;
  subject: string;
  body: string;
  priority: 'urgent' | 'normal' | 'low';
  timestamp: Date;
  read: boolean;
  archived: boolean;
  threadId?: string;
  attachments?: Attachment[];
}

interface OutgoingMessage {
  to: string;
  subject: string;
  body: string;
  priority?: 'urgent' | 'normal' | 'low';
  threadId?: string;
  attachments?: Attachment[];
}

interface Attachment {
  type: 'file' | 'diff' | 'skill' | 'code';
  name?: string;
  content: string;
}

interface InboxOptions {
  unreadOnly?: boolean;
  limit?: number;
  offset?: number;
  since?: Date;
}

CLI Commands

skillkit message send         # Send message to agent
skillkit message inbox        # View inbox
skillkit message read <id>    # Read a message
skillkit message reply <id>   # Reply to message
skillkit message archive <id> # Archive message
skillkit message sent         # View sent messages
skillkit message status       # Messaging status

Documentation

Full documentation: https://github.com/rohitg00/skillkit

License

Apache-2.0