dipclaw 0.1.0

package/config.example.json

@@ -0,0 +1,26 @@
+{
+  "name": "my-agent",
+  "workspace": "./workspace",
+  "llm": {
+    "protocol": "openai",
+    "baseUrl": "https://api.openai.com",
+    "apiKey": "${OPENAI_API_KEY}",
+    "model": "gpt-4o"
+  },
+  "telegram": {
+    "botToken": "${TELEGRAM_BOT_TOKEN}",
+    "allowedUsers": [123456789]
+  },
+  "maxIterations": 90,
+  "debug": false,
+  "browser": {
+    "headless": false,
+    "proxy": {
+      "protocol": "socks5",
+      "host": "127.0.0.1",
+      "port": 1080,
+      "username": "${PROXY_USER}",
+      "password": "${PROXY_PASS}"
+    }
+  }
+}

package/dist/agent/agent.d.ts

@@ -0,0 +1,85 @@
+import type { DipclawConfig } from "../config/types.js";
+export declare class Agent {
+    private config;
+    private llmClient;
+    private browser;
+    private taskRunner;
+    private scheduler;
+    private memory;
+    private skillGenerator;
+    private tui;
+    private telegramBot;
+    private chatHistory;
+    private conversationSummary;
+    private summarizationCooldown;
+    private browserLock;
+    constructor(config: DipclawConfig);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    getName(): string;
+    getWorkspace(): string;
+    /** Clear chat history and start a new session */
+    clearChat(): void;
+    /** Chat with the agent (LLM-driven, with tool use) */
+    chat(message: string): Promise<string>;
+    private chatInner;
+    /**
+     * Auto-save a brief memory about a complex chat workflow.
+     * Non-blocking — fires and forgets.
+     */
+    private autoSaveWorkflowMemory;
+    /** Chat with streaming — yields text deltas, handles tool calls internally */
+    chatStream(message: string): AsyncIterable<string>;
+    private chatStreamInner;
+    listTasks(): string;
+    addTask(name: string, cron: string, prompt: string): string;
+    removeTask(id: string): string;
+    toggleTask(id: string, enabled: boolean): string;
+    runTaskById(id: string): Promise<string>;
+    listSkills(): string;
+    generateSkill(logFileName: string): Promise<string>;
+    listMemories(): string;
+    /**
+     * Estimate character count of the chat history (rough proxy for tokens).
+     */
+    private estimateHistoryChars;
+    /**
+     * Compress chat history: try LLM summarization first, fallback to simple trim.
+     */
+    private compressHistory;
+    /**
+     * Summarize old messages via LLM and replace them with a compressed summary.
+     */
+    private performSummarization;
+    /**
+     * Format messages and call LLM to produce a conversation summary.
+     */
+    private summarizeMessages;
+    /**
+     * Format chat messages into readable text for the summarizer.
+     * Skips snapshot content (ephemeral page state, too large for summaries).
+     */
+    private formatMessagesForSummary;
+    /**
+     * Simple trim: drop old messages at user-message boundaries to fit budget.
+     * Fallback when summarization is unavailable.
+     */
+    private simpleTrim;
+    /**
+     * Build a copy of chatHistory with snapshot results managed:
+     * - If the latest user message involves browser activity, keep only the most recent snapshot.
+     * - Otherwise, omit all snapshots.
+     */
+    private buildMessagesForLlm;
+    private executeToolCall;
+    private executeBrowserAction;
+    private executeMemoryAction;
+    private executeSchedulerAction;
+    private buildChatSystemPrompt;
+    /**
+     * Acquire a serialized lock for browser access.
+     * All operations that may use the browser (chat, scheduled tasks) must go through this
+     * to prevent concurrent browser manipulation.
+     */
+    private acquireBrowserLock;
+}