minionsai 0.1.0

package/dist/server/server/workers/hermes_worker_utils.py

@@ -0,0 +1,39 @@
+"""Shared utilities for the Hermes worker and its submodules.
+
+Kept intentionally small: just the error type and pure helpers that are used
+across `hermes_worker.py`, `hermes_sessions.py`, and `hermes_cron.py`.
+"""
+
+from __future__ import annotations
+
+from typing import Any
+
+
+class WorkerError(Exception):
+    def __init__(self, message: str, code: str = "worker_error", hint: str | None = None):
+        super().__init__(message)
+        self.code = code
+        self.hint = hint
+
+
+def string_or_none(value: Any) -> str | None:
+    if isinstance(value, str):
+        stripped = value.strip()
+        return stripped or None
+    return None
+
+
+def json_safe(value: Any) -> Any:
+    if value is None or isinstance(value, (str, int, float, bool)):
+        return value
+    if isinstance(value, dict):
+        return {str(key): json_safe(val) for key, val in value.items()}
+    if isinstance(value, (list, tuple, set)):
+        return [json_safe(item) for item in value]
+    return str(value)
+
+
+def truncate_with_ellipsis(text: str, max_chars: int) -> str:
+    if len(text) <= max_chars:
+        return text
+    return text[: max_chars - 3].rstrip() + "..."

package/dist/server/shared/types.d.ts

@@ -0,0 +1,211 @@
+export declare const TASK_STATUSES: readonly ["in_progress", "in_review", "done"];
+export type TaskStatus = (typeof TASK_STATUSES)[number];
+export declare const REASONING_EFFORTS: readonly ["none", "minimal", "low", "medium", "high", "xhigh"];
+export type ReasoningEffort = (typeof REASONING_EFFORTS)[number];
+export interface AgentRunSettings {
+    model?: string | null;
+    reasoningEffort?: ReasoningEffort | null;
+}
+export interface Task {
+    id: string;
+    title: string;
+    description: string | null;
+    status: TaskStatus;
+    agent_model: string | null;
+    reasoning_effort: ReasoningEffort | null;
+    created_at: number;
+    updated_at: number;
+    last_agent_response_at: number | null;
+    last_viewed_at: number | null;
+    last_context_used_tokens: number | null;
+    last_context_window_tokens: number | null;
+}
+export interface TaskMessage {
+    id: string;
+    task_id: string;
+    role: 'user' | 'assistant' | 'system';
+    content: string;
+    thinking?: string;
+    created_at: number;
+}
+export interface ToolProgressEvent {
+    tool: string;
+    status: 'running' | 'completed' | 'error';
+    duration?: number;
+    label?: string;
+}
+export type LiveChatRunStatus = 'streaming' | 'done' | 'error';
+export interface TaskRunState {
+    taskId: string;
+    runId: string;
+    status: LiveChatRunStatus;
+    startedAt: number;
+    updatedAt: number;
+}
+export type BoardEvent = {
+    type: 'task_created';
+    task: Task;
+} | {
+    type: 'task_updated';
+    task: Task;
+} | {
+    type: 'task_deleted';
+    taskId: string;
+} | {
+    type: 'task_runs_snapshot';
+    runs: TaskRunState[];
+} | {
+    type: 'task_run_updated';
+    run: TaskRunState;
+};
+export type LiveChatMessage = TaskMessage & {
+    tools?: ToolProgressEvent[];
+};
+export interface LiveChatRun {
+    taskId: string;
+    runId: string;
+    sessionId: string;
+    status: LiveChatRunStatus;
+    startedAt: number;
+    updatedAt: number;
+    messages: LiveChatMessage[];
+    context?: ContextUsage | null;
+    error?: string;
+}
+export interface ContextUsage {
+    used_tokens: number;
+    window_tokens: number;
+}
+export interface SessionMetadata {
+    id: string;
+    input_tokens: number;
+    output_tokens: number;
+    cache_read_tokens: number;
+    cache_write_tokens: number;
+    reasoning_tokens: number;
+    estimated_cost_usd: number | null;
+    cost_status: string | null;
+    model: string | null;
+}
+export interface AgentDefaults {
+    provider: string | null;
+    model: string | null;
+    baseUrl: string | null;
+    apiMode: string | null;
+    reasoningEffort: ReasoningEffort | null;
+    showReasoning: boolean;
+}
+export interface AgentModelOption {
+    id: string;
+    label: string;
+    source: 'current' | 'catalog' | 'custom' | 'alias';
+    isCurrentDefault?: boolean;
+}
+export interface AgentModelGroup {
+    provider: string;
+    models: AgentModelOption[];
+}
+export interface AgentModelsResponse {
+    defaultModel: string | null;
+    activeProvider: string | null;
+    groups: AgentModelGroup[];
+}
+export interface TaskAgentSettings {
+    task: {
+        model: string | null;
+        reasoningEffort: ReasoningEffort | null;
+    };
+    defaults: AgentDefaults;
+    effective: {
+        model: string | null;
+        provider: string | null;
+        reasoningEffort: ReasoningEffort | null;
+    };
+}
+export interface CronJobOrigin {
+    platform?: string | null;
+    chat_id?: string | null;
+    chat_name?: string | null;
+    thread_id?: string | null;
+    [key: string]: unknown;
+}
+export interface CronJob {
+    id: string;
+    name: string;
+    prompt: string | null;
+    schedule: Record<string, unknown> | null;
+    scheduleDisplay: string | null;
+    enabled: boolean;
+    state: string | null;
+    nextRunAt: string | null;
+    lastRunAt: string | null;
+    lastStatus: CronStatus | null;
+    lastError: string | null;
+    lastDeliveryError: string | null;
+    model: string | null;
+    provider: string | null;
+    baseUrl: string | null;
+    deliver: string | null;
+    origin: CronJobOrigin | null;
+    skills: string[];
+    createdAt: string | null;
+    linkedTaskIds?: string[];
+}
+export type CronStatus = 'ok' | 'error' | 'unknown';
+export interface CronRun {
+    id: string;
+    jobId: string;
+    ranAt: string | null;
+    path: string;
+    status: CronStatus;
+    preview: string;
+    content?: string;
+}
+export type FileEntryType = 'file' | 'directory' | 'symlink' | 'other';
+export interface FileEntry {
+    name: string;
+    path: string;
+    displayPath: string;
+    type: FileEntryType;
+    hidden: boolean;
+    size: number | null;
+    modifiedAt: number | null;
+    readable: boolean;
+    writable: boolean;
+}
+export interface FileListResponse {
+    path: string;
+    displayPath: string;
+    parentPath: string | null;
+    entries: FileEntry[];
+}
+export interface FileReadResponse {
+    path: string;
+    displayPath: string;
+    name: string;
+    content: string;
+    size: number;
+    modifiedAt: number;
+    encoding: 'utf8';
+    fileType: 'text';
+}
+export interface FileWriteResponse {
+    path: string;
+    displayPath: string;
+    size: number;
+    modifiedAt: number;
+}
+export type FileCreateType = 'file' | 'directory';
+export interface FileCreateResponse {
+    entry: FileEntry;
+}
+export interface FileRenameResponse {
+    entry: FileEntry;
+}
+export interface FileDeleteResponse {
+    ok: true;
+}
+export interface FileUploadResponse {
+    uploaded: number;
+    entries: FileEntry[];
+}

package/dist/server/shared/types.js

@@ -0,0 +1,2 @@
+export const TASK_STATUSES = ['in_progress', 'in_review', 'done'];
+export const REASONING_EFFORTS = ['none', 'minimal', 'low', 'medium', 'high', 'xhigh'];

package/package.json

@@ -0,0 +1,74 @@
+{
+  "name": "minionsai",
+  "version": "0.1.0",
+  "description": "Mission Control for Hermes Agent — a Kanban board for autonomous agent tasks",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "minions": "bin/minions.mjs"
+  },
+  "files": [
+    "bin",
+    "dist",
+    "skills",
+    "LICENSE",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "dev": "NODE_ENV=development tsx watch server/index.ts",
+    "dev:server": "NODE_ENV=development tsx watch server/index.ts",
+    "clean": "rm -rf dist",
+    "build": "npm run clean && npm run build:server && npm run build:client && npm run build:assets",
+    "build:client": "cd client && npx vite build --outDir ../dist/server/client/dist --emptyOutDir",
+    "build:server": "npx tsc -p server/tsconfig.json",
+    "build:assets": "rsync -a --prune-empty-dirs --exclude='__pycache__' --include='*/' --include='*.sql' --include='*.py' --exclude='*' server/ dist/server/server/",
+    "start": "NODE_ENV=production node dist/server/server/index.js",
+    "prod": "npm run build && npm run start",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@dnd-kit/core": "^6.3.1",
+    "@dnd-kit/sortable": "^10.0.0",
+    "@dnd-kit/utilities": "^3.2.2",
+    "@streamdown/code": "^1.1.1",
+    "@types/papaparse": "^5.5.2",
+    "ag-grid-community": "^33.2.5",
+    "ag-grid-react": "^33.2.5",
+    "archiver": "^7.0.1",
+    "better-sqlite3": "^11.7.0",
+    "cors": "^2.8.5",
+    "dotenv": "^16.4.7",
+    "express": "^4.21.2",
+    "lucide-react": "^1.12.0",
+    "multer": "^2.1.1",
+    "papaparse": "^5.5.3",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "react-router": "^7.14.2",
+    "react-router-dom": "^7.14.2",
+    "streamdown": "^2.4.0",
+    "uuid": "^11.0.5",
+    "zustand": "^5.0.12"
+  },
+  "devDependencies": {
+    "@types/archiver": "^7.0.0",
+    "@types/better-sqlite3": "^7.6.12",
+    "@types/cors": "^2.8.17",
+    "@types/express": "^5.0.0",
+    "@types/multer": "^2.1.0",
+    "@types/node": "^22.10.5",
+    "@types/react": "^19.0.0",
+    "@types/react-dom": "^19.0.0",
+    "@types/uuid": "^10.0.0",
+    "@vitejs/plugin-react": "^4.3.4",
+    "autoprefixer": "^10.4.20",
+    "postcss": "^8.4.49",
+    "tailwindcss": "^3.4.17",
+    "tsx": "^4.19.2",
+    "typescript": "^5.7.3",
+    "vite": "^6.0.7"
+  }
+}

package/skills/lead-generation/SKILL.md

@@ -0,0 +1,41 @@
+---
+name: lead-generation
+description: This skill should be used for lead generation or prospecting tasks. It guides the agent through a lightweight workflow: understand the target, collect sample leads, validate columns and quality, then continue collection into a local CSV file.
+---
+
+# Lead Generation
+
+Guide users from a vague lead generation goal to a validated CSV-producing workflow.
+
+## Workflow
+
+### Phase 1: Understand the Target
+
+If the user hasn't already given enough context to start, you can ask 1 or 2 follow up questions max: 
+
+- **Who** — ideal customer profile (industry, company size, role/title, geography)
+- **Why** — what the leads are for (outbound sales, partnerships, recruiting, research)
+
+You can follow up later if needed, after you do a sample run.
+
+### Phase 2: Test Leads
+
+Collect 2-3 leads and present them in a table. Choose columns that make sense for the user's specific task — there is no fixed schema. The columns should emerge naturally from the targeting criteria and what information is discoverable.
+
+Present the test leads and let the user react. They may want to adjust columns, targeting, or format — follow their lead. Do not scale collection until the user signals they're happy with the results.
+
+### Phase 3: Continue Collection
+
+Once the user signs off, continue collection. Focus on:
+
+- **Batch size** — default to 3-5 leads per run unless the user specifies otherwise.
+- **CSV location** — store in the working directory. Suggest a descriptive filename (e.g., `leads-saas-founders.csv`). Create the file with headers and the test leads already included.
+- **Instructions** — any continued collection should be self-contained: describe the ICP, the CSV path, the columns, and the number of leads to collect per run.
+
+### Guidance
+
+- Always start with test leads. Never scale collection before validating the target and columns.
+- Wait for the user to signal they're happy before continuing collection — don't ask for permission, just don't proceed until they indicate satisfaction.
+- If the user has a specific source in mind, incorporate it. Otherwise, choose appropriate sources.
+- If the user already has a CSV or lead list, continue appending to it rather than starting fresh.
+- Bias toward doing and showing over asking. Present what was done and let the user course-correct.