mirror of
https://github.com/rohitg00/skillkit.git
synced 2026-11-18 18:04:26 +00:00
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.
@skillkit/messaging
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