openpaean 0.4.2 → 0.5.1

package/dist/worker/types.d.ts

@@ -0,0 +1,134 @@
+/**
+ * Worker Types
+ * Type definitions for the OpenPaean Local Autonomous Worker
+ */
+import type { TodoItem } from '../api/todo.js';
+export interface WorkerConfig {
+    pollInterval: number;
+    maxRetries: number;
+    taskTimeout: number;
+    cooldownOnError: number;
+    verificationEnabled: boolean;
+    workingDirectory?: string;
+    debug?: boolean;
+    autonomousMode?: boolean;
+}
+export declare const DEFAULT_WORKER_CONFIG: WorkerConfig;
+export interface TaskContext {
+    task: TodoItem;
+    attempt: number;
+    maxRetries: number;
+    previousFailureSummary?: string;
+    startedAt: Date;
+    conversationId?: string;
+}
+export type WorkerStatus = 'idle' | 'running' | 'paused' | 'stopping' | 'error';
+export interface WorkerState {
+    status: WorkerStatus;
+    currentTask?: TaskContext;
+    completedCount: number;
+    failedCount: number;
+    startedAt?: Date;
+    lastError?: string;
+    lastPollAt?: Date;
+}
+export interface TaskResult {
+    success: boolean;
+    message?: string;
+    verificationPassed?: boolean;
+    error?: string;
+    durationMs?: number;
+}
+export type WorkerEvent = {
+    type: 'started';
+} | {
+    type: 'stopped';
+} | {
+    type: 'paused';
+} | {
+    type: 'resumed';
+} | {
+    type: 'task_claimed';
+    task: TodoItem;
+} | {
+    type: 'task_started';
+    task: TodoItem;
+    attempt: number;
+} | {
+    type: 'task_completed';
+    task: TodoItem;
+    duration: number;
+} | {
+    type: 'task_failed';
+    task: TodoItem;
+    error: string;
+    willRetry: boolean;
+} | {
+    type: 'task_verification_failed';
+    task: TodoItem;
+} | {
+    type: 'poll_empty';
+} | {
+    type: 'error';
+    error: string;
+} | {
+    type: 'worker_content';
+    text: string;
+    partial: boolean;
+} | {
+    type: 'worker_tool_call';
+    id: string;
+    name: string;
+    isMcp: boolean;
+    serverName?: string;
+} | {
+    type: 'worker_tool_result';
+    id: string;
+    name: string;
+    status: 'completed' | 'error';
+} | {
+    type: 'worker_done';
+    taskId: string;
+    success: boolean;
+    output?: string;
+};
+export type WorkerEventHandler = (event: WorkerEvent) => void;
+export type ExecutorType = 'internal' | 'claude' | 'gemini' | 'cursor' | 'codex' | 'opencode' | 'articulate' | 'shell';
+export interface ExecutorConfig {
+    type: ExecutorType;
+    enabled: boolean;
+    path?: string;
+    defaultArgs?: string[];
+    timeout?: number;
+}
+export type AvailabilityAuthStatus = 'authenticated' | 'unauthenticated' | 'expired' | 'unknown';
+export interface AvailabilityStatus {
+    available: boolean;
+    binaryExists: boolean;
+    binaryPath?: string;
+    authStatus: AvailabilityAuthStatus;
+    authMessage?: string;
+    version?: string;
+    error?: string;
+}
+export interface ExecutorOptions {
+    cwd?: string;
+    timeout?: number;
+    args?: string[];
+    env?: Record<string, string>;
+    skipPermissions?: boolean;
+    captureOutput?: boolean;
+    onOutput?: (text: string, stream: 'stdout' | 'stderr') => void;
+    onProgress?: (message: string) => void;
+}
+export interface ExecutorResult {
+    success: boolean;
+    output: string;
+    error?: string;
+    exitCode?: number;
+    durationMs: number;
+    structured?: Record<string, unknown>;
+}
+export declare const DEFAULT_EXECUTOR_CONFIG: Partial<Record<ExecutorType, ExecutorConfig>>;
+export declare function buildTaskPrompt(ctx: TaskContext): string;
+//# sourceMappingURL=types.d.ts.map

package/dist/worker/types.d.ts.map

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

package/dist/worker/types.js

@@ -0,0 +1,70 @@
+/**
+ * Worker Types
+ * Type definitions for the OpenPaean Local Autonomous Worker
+ */
+import os from 'os';
+export const DEFAULT_WORKER_CONFIG = {
+    pollInterval: 30000,
+    maxRetries: 3,
+    taskTimeout: 600000,
+    cooldownOnError: 60000,
+    verificationEnabled: true,
+    autonomousMode: true,
+};
+export const DEFAULT_EXECUTOR_CONFIG = {
+    internal: { type: 'internal', enabled: true },
+    claude: { type: 'claude', enabled: true, timeout: 900000 },
+    gemini: { type: 'gemini', enabled: true, timeout: 600000 },
+    cursor: { type: 'cursor', enabled: true, timeout: 600000 },
+    codex: { type: 'codex', enabled: true, timeout: 600000 },
+    opencode: { type: 'opencode', enabled: true, timeout: 600000 },
+    articulate: { type: 'articulate', enabled: true, timeout: 600000 },
+};
+export function buildTaskPrompt(ctx) {
+    const task = ctx.task;
+    const cliPayload = task.cliPayload;
+    const workingDir = cliPayload?.workingDirectory || process.cwd();
+    const basePrompt = `You are an autonomous AI assistant running on the user's local machine.
+You have access to both local tools (filesystem, terminal, git) and cloud tools (notes, todos, search).
+
+## Task
+ID: ${ctx.task.id}
+Content: ${ctx.task.content}
+Priority: ${ctx.task.priority}
+${ctx.task.description ? `\nDetails: ${ctx.task.description}` : ''}
+${ctx.task.tags?.length ? `\nTags: ${ctx.task.tags.join(', ')}` : ''}
+${cliPayload?.hint ? `\nHint: ${cliPayload.hint}` : ''}
+
+## Your Environment
+- Working Directory: ${workingDir}
+- Device: ${process.env.HOSTNAME || os.hostname()}
+- Platform: ${process.platform}
+${cliPayload?.context ? `\nAdditional Context: ${JSON.stringify(cliPayload.context)}` : ''}
+
+## Instructions
+1. Analyze what needs to be done
+2. Use available tools to complete the task autonomously
+3. Verify your work is correct
+4. Call paean_complete_task when finished
+
+## Available Tool Categories
+- **Local MCP**: File read/write, shell commands, git operations
+- **Cloud MCP**: Notes, todos, search, transcriptions
+
+## Important
+- You have full autonomy to decide HOW to complete the task
+- Use your best judgment on which tools to use
+- If you encounter errors, try alternative approaches
+- Ask for confirmation only for potentially destructive operations
+`;
+    if (ctx.attempt > 1 && ctx.previousFailureSummary) {
+        return `${basePrompt}
+## Previous Attempt Failed (Attempt ${ctx.attempt}/${ctx.maxRetries})
+${ctx.previousFailureSummary}
+
+Please review the previous failure and try a different approach.
+`;
+    }
+    return basePrompt;
+}
+//# sourceMappingURL=types.js.map

package/dist/worker/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/worker/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,IAAI,CAAC;AAcpB,MAAM,CAAC,MAAM,qBAAqB,GAAiB;IAC/C,YAAY,EAAE,KAAK;IACnB,UAAU,EAAE,CAAC;IACb,WAAW,EAAE,MAAM;IACnB,eAAe,EAAE,KAAK;IACtB,mBAAmB,EAAE,IAAI;IACzB,cAAc,EAAE,IAAI;CACvB,CAAC;AAwGF,MAAM,CAAC,MAAM,uBAAuB,GAAkD;IAClF,QAAQ,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE;IAC7C,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE;IAC1D,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE;IAC1D,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE;IAC1D,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE;IACxD,QAAQ,EAAE,EAAE,IAAI,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE;IAC9D,UAAU,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE;CACrE,CAAC;AAEF,MAAM,UAAU,eAAe,CAAC,GAAgB;IAC5C,MAAM,IAAI,GAAG,GAAG,CAAC,IAAwG,CAAC;IAC1H,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;IACnC,MAAM,UAAU,GAAG,UAAU,EAAE,gBAAgB,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;IAEjE,MAAM,UAAU,GAAG;;;;MAIjB,GAAG,CAAC,IAAI,CAAC,EAAE;WACN,GAAG,CAAC,IAAI,CAAC,OAAO;YACf,GAAG,CAAC,IAAI,CAAC,QAAQ;EAC3B,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC,CAAC,cAAc,GAAG,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE;EAChE,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;EAClE,UAAU,EAAE,IAAI,CAAC,CAAC,CAAC,WAAW,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE;;;uBAG/B,UAAU;YACrB,OAAO,CAAC,GAAG,CAAC,QAAQ,IAAI,EAAE,CAAC,QAAQ,EAAE;cACnC,OAAO,CAAC,QAAQ;EAC5B,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,yBAAyB,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE;;;;;;;;;;;;;;;;;CAiBzF,CAAC;IAEE,IAAI,GAAG,CAAC,OAAO,GAAG,CAAC,IAAI,GAAG,CAAC,sBAAsB,EAAE,CAAC;QAChD,OAAO,GAAG,UAAU;sCACU,GAAG,CAAC,OAAO,IAAI,GAAG,CAAC,UAAU;EACjE,GAAG,CAAC,sBAAsB;;;CAG3B,CAAC;IACE,CAAC;IAED,OAAO,UAAU,CAAC;AACtB,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "openpaean",
-    "version": "0.4.2",
-    "description": "Open source AI agent CLI with shell tools, custom MCP support, scrolling TUI and local MCP integration",
+    "version": "0.5.1",
+    "description": "Open source AI agent CLI with executor framework (a8e, Claude Code), gateway relay, worker mode, MCP support, and scrolling TUI",
     "author": "Paean AI <dev@paean.ai>",
     "license": "MIT",
     "type": "module",
@@ -74,7 +74,12 @@
         "agent",
         "shell",
         "custom-mcp",
-        "fullscreen"
+        "fullscreen",
+        "gateway",
+        "worker",
+        "executor",
+        "a8e",
+        "claude-code"
     ],
     "homepage": "https://github.com/paean-ai/openpaean",
     "bugs": {