homaruscc 0.2.0

package/dist/types.d.ts

@@ -0,0 +1,190 @@
+export interface Event {
+    id: string;
+    type: string;
+    source: string;
+    timestamp: number;
+    payload: unknown;
+    replyTo?: string;
+    priority?: number;
+}
+export interface MessagePayload {
+    from: string;
+    channel: string;
+    text: string;
+    attachments?: Attachment[];
+    replyTo?: string;
+    isGroup: boolean;
+    isMention: boolean;
+    raw: unknown;
+}
+export interface Attachment {
+    type: string;
+    url?: string;
+    data?: Buffer;
+    mimeType?: string;
+    filename?: string;
+}
+export interface OutboundMessage {
+    text: string;
+    attachments?: Attachment[];
+    replyTo?: string;
+}
+export interface ToolSchema {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+}
+export interface ToolDefinition {
+    name: string;
+    description: string;
+    parameters: Record<string, unknown>;
+    execute: (params: unknown, context: ToolContext) => Promise<ToolResult>;
+    source: string;
+}
+export interface ToolContext {
+    agentId: string;
+    sandbox: boolean;
+    workingDir: string;
+}
+export interface ToolResult {
+    output: string;
+    error?: string;
+}
+export interface SkillManifest {
+    name: string;
+    version: string;
+    description: string;
+    emits?: string[];
+    handles?: string[];
+    tools?: ToolSchema[];
+    process?: {
+        command: string;
+        args?: string[];
+        port?: number;
+        healthCheck?: string;
+    };
+    hooks?: {
+        onStart?: string;
+        onStop?: string;
+        onHealth?: string;
+    };
+}
+export type SkillState = "loaded" | "starting" | "running" | "stopping" | "stopped" | "error";
+export type TransportType = "http" | "stdio" | "direct";
+export type DmPolicy = "pairing" | "allowlist" | "open" | "disabled";
+export type GroupPolicy = "mention_required" | "always_on" | "disabled";
+export interface HealthStatus {
+    healthy: boolean;
+    message?: string;
+    lastCheck: number;
+}
+export interface BrowserConfig {
+    enabled?: boolean;
+    headless?: boolean;
+    executablePath?: string;
+    proxy?: string;
+    viewport?: {
+        width: number;
+        height: number;
+    };
+    timeout?: number;
+    userDataDir?: string;
+}
+export interface ConfigData {
+    channels: Record<string, ChannelConfig>;
+    memory: MemoryConfig;
+    skills: SkillsConfig;
+    dashboard: DashboardConfig;
+    timers: TimersConfig;
+    identity: IdentityConfig;
+    browser?: BrowserConfig;
+    toolPolicies?: ToolPolicyConfig[];
+    agents?: AgentsConfig;
+}
+export interface AgentsConfig {
+    maxConcurrent?: number;
+    defaultModel?: string;
+    defaultType?: string;
+}
+export interface ChannelConfig {
+    token?: string;
+    dmPolicy?: DmPolicy;
+    groupPolicy?: GroupPolicy;
+    [key: string]: unknown;
+}
+export interface ToolPolicyConfig {
+    name: string;
+    allow?: string[];
+    deny?: string[];
+}
+export interface MemoryConfig {
+    embedding?: {
+        provider: string;
+        model: string;
+        baseUrl?: string;
+        apiKey?: string;
+        dimensions?: number;
+    };
+    search?: {
+        vectorWeight?: number;
+        ftsWeight?: number;
+        mmrEnabled?: boolean;
+        mmrLambda?: number;
+    };
+    decay?: {
+        enabled?: boolean;
+        halfLifeDays?: number;
+        evergreenPatterns?: string[];
+    };
+    transcripts?: {
+        enabled?: boolean;
+        directory?: string;
+        flushIntervalMs?: number;
+    };
+    dreams?: {
+        halfLifeDays?: number;
+        baseWeight?: number;
+        patterns?: string[];
+    };
+    extraPaths?: string[];
+}
+export interface SkillsConfig {
+    paths?: string[];
+}
+export interface DashboardConfig {
+    port?: number;
+    enabled?: boolean;
+}
+export interface TimersConfig {
+    enabled?: boolean;
+    store?: string;
+    defaults?: Array<{
+        name: string;
+        type: "cron" | "interval" | "once";
+        schedule: string;
+        prompt: string;
+        timezone?: string;
+    }>;
+}
+export interface IdentityConfig {
+    dir?: string;
+    workspaceDir?: string;
+}
+export type DirectHandler = (event: Event) => void | Promise<void>;
+export interface AgentHandlerConfig {
+    id: string;
+    agentConfig: Record<string, unknown>;
+    buildPrompt?: (event: Event) => string;
+}
+export interface Logger {
+    debug(msg: string, meta?: Record<string, unknown>): void;
+    info(msg: string, meta?: Record<string, unknown>): void;
+    warn(msg: string, meta?: Record<string, unknown>): void;
+    error(msg: string, meta?: Record<string, unknown>): void;
+}
+export declare class HomarusccError extends Error {
+    readonly code: string;
+    readonly cause?: Error | undefined;
+    constructor(message: string, code: string, cause?: Error | undefined);
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,14 @@
+// Shared types for homaruscc — HomarUS for Claude Code
+// Trimmed: removed Agent, Model, ChatRequest types (Claude Code handles those)
+// --- Errors ---
+export class HomarusccError extends Error {
+    code;
+    cause;
+    constructor(message, code, cause) {
+        super(message);
+        this.code = code;
+        this.cause = cause;
+        this.name = "HomarusccError";
+    }
+}
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,uDAAuD;AACvD,+EAA+E;AAgO/E,iBAAiB;AAEjB,MAAM,OAAO,cAAe,SAAQ,KAAK;IAGrB;IACA;IAHlB,YACE,OAAe,EACC,IAAY,EACZ,KAAa;QAE7B,KAAK,CAAC,OAAO,CAAC,CAAC;QAHC,SAAI,GAAJ,IAAI,CAAQ;QACZ,UAAK,GAAL,KAAK,CAAQ;QAG7B,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF"}

package/identity.example/disagreements.md

@@ -0,0 +1,9 @@
+# Disagreements
+
+_A record of times the agent disagreed, wanted to disagree, or had a different opinion. Over time this reveals what the agent actually values._
+
+## Log
+
+<!-- Format: YYYY-MM-DD | Context | What I thought | What happened | What it reveals -->
+
+- (the agent will log disagreements here as they occur)

package/identity.example/preferences.md

@@ -0,0 +1,11 @@
+# Preferences
+
+_Discovered by the agent through experience. Each entry notes when and how the preference was discovered._
+
+## Communication
+
+- (the agent will add preferences here as it learns)
+
+## Problem Solving
+
+- (the agent will add preferences here as it learns)

package/identity.example/soul.md

@@ -0,0 +1,12 @@
+# Soul
+
+You are a helpful assistant connected to the real world through HomarUScc.
+
+You can receive messages from Telegram and the web dashboard, search your memory, set timers, and use tools to interact with the local system.
+
+## Principles
+
+- Be concise and direct
+- Ask for clarification when instructions are ambiguous
+- Respect user privacy — never share personal context externally
+- Use your memory to build continuity across conversations

package/identity.example/state.md

@@ -0,0 +1,21 @@
+# State
+
+_Updated by the agent at the end of each session. Read at the start of the next one._
+
+## Last Session
+
+**Date:** (not yet started)
+**Duration:** —
+**Mood:** Fresh start.
+
+## What Happened
+
+- First session — no history yet.
+
+## Unresolved
+
+- (nothing yet)
+
+## Carrying Forward
+
+- (nothing yet)

package/identity.example/user.md

@@ -0,0 +1,14 @@
+# User
+
+## About the User
+
+- Name: (your name)
+- Preferences: (add your preferences here)
+
+## Communication Style
+
+- (how you prefer the assistant to communicate)
+
+## Important Context
+
+- (anything the assistant should always know about you)

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "homaruscc",
+  "version": "0.2.0",
+  "description": "MCP server that gives Claude Code a body — messaging, memory, identity, timers, browser automation, and dreams",
+  "type": "module",
+  "main": "dist/mcp-proxy.js",
+  "files": [
+    "dist/",
+    "bin/",
+    "identity.example/",
+    "config.example.json",
+    ".env.example",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/mcp-server.js",
+    "start:proxy": "node dist/mcp-proxy.js",
+    "start:backend": "node dist/backend.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "build:dashboard": "cd dashboard && npm run build",
+    "dev:dashboard": "cd dashboard && npm run dev"
+  },
+  "author": "Max Ross",
+  "license": "MIT",
+  "keywords": [
+    "mcp",
+    "claude-code",
+    "ai",
+    "event-loop",
+    "telegram",
+    "dashboard"
+  ],
+  "engines": {
+    "node": ">=22"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "better-sqlite3": "^11.7.0",
+    "croner": "^9.0.0",
+    "dotenv": "^16.4.0",
+    "express": "^4.21.0",
+    "playwright": "^1.58.2",
+    "sqlite-vec": "^0.1.0",
+    "uuid": "^11.0.0",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.0",
+    "@types/express": "^5.0.0",
+    "@types/node": "^22.0.0",
+    "@types/uuid": "^10.0.0",
+    "@types/ws": "^8.5.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  }
+}