profclaw 0.0.1-beta.3 → 2.3.0

package/dist/cli/providers.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Shared AI provider catalog for CLI wizards (onboard + setup).
+ */
+export interface ProviderEntry {
+    key: string;
+    name: string;
+    models: string;
+    envVar: string;
+    category: string;
+    tag: string;
+}
+export declare const PROVIDER_CATALOG: ProviderEntry[];
+/** All env var keys used by providers (for .env writing). */
+export declare const PROVIDER_ENV_KEYS: string[];
+//# sourceMappingURL=providers.d.ts.map

package/dist/cli/providers.js

@@ -0,0 +1,41 @@
+/**
+ * Shared AI provider catalog for CLI wizards (onboard + setup).
+ */
+export const PROVIDER_CATALOG = [
+    // Popular
+    { key: 'anthropic', name: 'Anthropic', models: 'Claude 4.x, 3.5 Sonnet', envVar: 'ANTHROPIC_API_KEY', category: 'Popular', tag: 'recommended' },
+    { key: 'openai', name: 'OpenAI', models: 'GPT-4o, o1, o3', envVar: 'OPENAI_API_KEY', category: 'Popular', tag: '' },
+    { key: 'google', name: 'Google AI', models: 'Gemini 2.x, Flash', envVar: 'GOOGLE_GENERATIVE_AI_API_KEY', category: 'Popular', tag: '' },
+    { key: 'ollama', name: 'Ollama', models: 'Llama, Mistral, Qwen', envVar: 'OLLAMA_BASE_URL', category: 'Popular', tag: 'free, local' },
+    // Fast Inference
+    { key: 'groq', name: 'Groq', models: 'Llama, Mixtral', envVar: 'GROQ_API_KEY', category: 'Fast Inference', tag: 'fast' },
+    { key: 'cerebras', name: 'Cerebras', models: 'Llama 3.3 70B', envVar: 'CEREBRAS_API_KEY', category: 'Fast Inference', tag: 'fast' },
+    { key: 'fireworks', name: 'Fireworks', models: 'Llama, Mixtral', envVar: 'FIREWORKS_API_KEY', category: 'Fast Inference', tag: '' },
+    { key: 'together', name: 'Together', models: 'Open models', envVar: 'TOGETHER_API_KEY', category: 'Fast Inference', tag: '' },
+    // Enterprise
+    { key: 'azure', name: 'Azure OpenAI', models: 'GPT-4o', envVar: 'AZURE_OPENAI_API_KEY', category: 'Enterprise', tag: 'enterprise' },
+    { key: 'bedrock', name: 'AWS Bedrock', models: 'Claude, Titan, Llama', envVar: 'AWS_ACCESS_KEY_ID', category: 'Enterprise', tag: 'enterprise' },
+    { key: 'watsonx', name: 'IBM Watsonx', models: 'Granite, Llama', envVar: 'WATSONX_API_KEY', category: 'Enterprise', tag: 'enterprise' },
+    // More Providers
+    { key: 'deepseek', name: 'DeepSeek', models: 'V3, R1 (reasoning)', envVar: 'DEEPSEEK_API_KEY', category: 'More Providers', tag: '' },
+    { key: 'mistral', name: 'Mistral', models: 'Large, Codestral', envVar: 'MISTRAL_API_KEY', category: 'More Providers', tag: '' },
+    { key: 'xai', name: 'xAI', models: 'Grok', envVar: 'XAI_API_KEY', category: 'More Providers', tag: '' },
+    { key: 'perplexity', name: 'Perplexity', models: 'Sonar (search)', envVar: 'PERPLEXITY_API_KEY', category: 'More Providers', tag: 'search' },
+    { key: 'cohere', name: 'Cohere', models: 'Command R+', envVar: 'COHERE_API_KEY', category: 'More Providers', tag: '' },
+    // Aggregators
+    { key: 'openrouter', name: 'OpenRouter', models: 'Any model (proxy)', envVar: 'OPENROUTER_API_KEY', category: 'Aggregators', tag: 'multi-model' },
+    { key: 'replicate', name: 'Replicate', models: 'Open-source models', envVar: 'REPLICATE_API_TOKEN', category: 'Aggregators', tag: '' },
+    { key: 'github-models', name: 'GitHub Models', models: 'Azure-backed', envVar: 'GITHUB_TOKEN', category: 'Aggregators', tag: '' },
+    { key: 'huggingface', name: 'HuggingFace', models: 'Inference API', envVar: 'HF_TOKEN', category: 'Aggregators', tag: '' },
+    { key: 'nvidia-nim', name: 'NVIDIA NIM', models: 'Llama, Nemotron', envVar: 'NVIDIA_NIM_API_KEY', category: 'Aggregators', tag: '' },
+    // Asia
+    { key: 'zhipu', name: 'Zhipu AI', models: 'GLM-4, GLM-5', envVar: 'ZHIPU_API_KEY', category: 'Asia', tag: '' },
+    { key: 'moonshot', name: 'Moonshot', models: 'Kimi (128K context)', envVar: 'MOONSHOT_API_KEY', category: 'Asia', tag: '' },
+    { key: 'qwen', name: 'Qwen', models: 'Qwen Max, Plus', envVar: 'QWEN_API_KEY', category: 'Asia', tag: '' },
+    { key: 'minimax', name: 'MiniMax', models: 'abab series', envVar: 'MINIMAX_API_KEY', category: 'Asia', tag: '' },
+    { key: 'volcengine', name: 'Volcengine', models: 'Doubao (Bytedance)', envVar: 'VOLCENGINE_API_KEY', category: 'Asia', tag: '' },
+    { key: 'qianfan', name: 'Qianfan', models: 'ERNIE (Baidu)', envVar: 'QIANFAN_API_KEY', category: 'Asia', tag: '' },
+];
+/** All env var keys used by providers (for .env writing). */
+export const PROVIDER_ENV_KEYS = PROVIDER_CATALOG.map(p => p.envVar);
+//# sourceMappingURL=providers.js.map

package/dist/cli/utils/api.d.ts

@@ -4,6 +4,15 @@ export interface ApiResponse<T = unknown> {
     data?: T;
     error?: string;
 }
+/**
+ * Auto-detect the profClaw server by probing /health on candidate ports.
+ * Caches the result so subsequent calls don't re-probe.
+ * Uses a shared promise to deduplicate concurrent calls.
+ *
+ * Exported so callers that need the base URL directly (e.g. TUI, REPL, print
+ * mode) can share the same detection logic without duplicating it.
+ */
+export declare function detectBaseUrl(): Promise<string>;
 /**
  * Make an API request to the profClaw server
  */

package/dist/cli/utils/api.js

@@ -1,12 +1,68 @@
 import { getConfig } from './config.js';
+/** Ports to probe when looking for a running profClaw server. */
+const CANDIDATE_PORTS = ['3000', '3001', '3002', '9100'];
+let resolvedBaseUrl;
+let detectPromise;
+/**
+ * Auto-detect the profClaw server by probing /health on candidate ports.
+ * Caches the result so subsequent calls don't re-probe.
+ * Uses a shared promise to deduplicate concurrent calls.
+ *
+ * Exported so callers that need the base URL directly (e.g. TUI, REPL, print
+ * mode) can share the same detection logic without duplicating it.
+ */
+export async function detectBaseUrl() {
+    if (resolvedBaseUrl)
+        return resolvedBaseUrl;
+    if (detectPromise)
+        return detectPromise;
+    detectPromise = doDetect();
+    return detectPromise;
+}
+async function doDetect() {
+    // If PORT env is set, use it directly (user knows best)
+    if (process.env.PORT) {
+        resolvedBaseUrl = `http://localhost:${process.env.PORT}`;
+        return resolvedBaseUrl;
+    }
+    // Check user-configured apiUrl from config file (not the default)
+    const config = getConfig();
+    const configPath = config.apiUrl;
+    const isUserConfigured = configPath && configPath !== 'http://localhost:3000';
+    if (isUserConfigured) {
+        resolvedBaseUrl = configPath;
+        return resolvedBaseUrl;
+    }
+    // Probe candidate ports for a running profClaw server
+    for (const port of CANDIDATE_PORTS) {
+        try {
+            const res = await fetch(`http://localhost:${port}/health`, {
+                signal: AbortSignal.timeout(1000),
+            });
+            if (res.ok) {
+                const body = await res.json();
+                if (body.service === 'profclaw') {
+                    resolvedBaseUrl = `http://localhost:${port}`;
+                    return resolvedBaseUrl;
+                }
+            }
+        }
+        catch {
+            // Port not responding or not profClaw — try next
+        }
+    }
+    // Fallback to default
+    resolvedBaseUrl = 'http://localhost:3000';
+    return resolvedBaseUrl;
+}
 /**
  * Make an API request to the profClaw server
  */
 export async function apiRequest(method, path, body) {
-    const config = getConfig();
-    const baseUrl = config.apiUrl || 'http://localhost:3000';
+    const baseUrl = await detectBaseUrl();
     const url = `${baseUrl}${path}`;
     try {
+        const config = getConfig();
         const headers = {
             'Content-Type': 'application/json',
         };

package/dist/core/deployment.js

@@ -9,6 +9,8 @@ const MODE_CAPABILITIES = {
         'agent',
         'tools',
         'chat_cli',
+        'chat_channels',
+        'cron',
     ]),
     mini: new Set([
         'agent',

package/dist/cron/natural-language.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Natural Language Cron Parser
+ *
+ * Converts human-readable scheduling descriptions into cron expressions
+ * and structured job parameters. This is the "just tell me what you want"
+ * layer that makes profClaw feel autonomous.
+ *
+ * Examples:
+ *   "every morning at 8am summarize GitHub notifications"
+ *   "every friday at 5pm send sprint report to slack"
+ *   "check server health every 30 minutes"
+ *   "once a day at midnight clean up old logs"
+ *   "every weekday at 9am pull RSS feeds and send digest to telegram"
+ */
+import type { CreateJobParams, DeliveryChannelType } from './scheduler.js';
+export interface ParsedSchedule {
+    cronExpression?: string;
+    intervalMs?: number;
+    runAt?: Date;
+    timezone: string;
+    confidence: number;
+    humanReadable: string;
+}
+export interface ParsedIntent {
+    action: string;
+    target?: string;
+    details: Record<string, string>;
+}
+export interface ParsedDelivery {
+    channel: DeliveryChannelType;
+    target: string;
+}
+export interface NaturalLanguageResult {
+    success: boolean;
+    schedule?: ParsedSchedule;
+    intent?: ParsedIntent;
+    delivery?: ParsedDelivery;
+    jobParams?: CreateJobParams;
+    rawInput: string;
+    error?: string;
+}
+/**
+ * Parse a natural language automation request into structured job params.
+ */
+export declare function parseNaturalLanguage(input: string): NaturalLanguageResult;
+/**
+ * Validate a cron expression (basic check).
+ */
+export declare function isValidCron(expression: string): boolean;
+/**
+ * Convert a cron expression to a human-readable string.
+ */
+export declare function cronToHuman(expression: string): string;
+//# sourceMappingURL=natural-language.d.ts.map