comisai 1.0.19 → 1.0.22

package/node_modules/@comis/cli/dist/wizard/flow-types.d.ts

@@ -1,48 +0,0 @@
-/**
- * Shared types and constants for the init wizard flows.
- *
- * Provides the WizardResult, ChannelSetup, and ProviderChoice types
- * used by both QuickStart and Manual flows, plus constant arrays
- * for providers, channel types, and minimum key lengths.
- *
- * @module
- */
-/** Result collected from any wizard flow. */
-export interface WizardResult {
-    provider: string;
-    agentName: string;
-    apiKey?: string;
-    model?: string;
-    channels?: ChannelSetup[];
-    gatewayEnabled?: boolean;
-    gatewayHost?: string;
-    gatewayPort?: number;
-    gatewayToken?: string;
-    dataDir?: string;
-}
-/** Channel configuration collected during the wizard. */
-export interface ChannelSetup {
-    type: "telegram" | "discord" | "slack" | "whatsapp" | "signal" | "irc" | "line";
-    botToken?: string;
-    apiKey?: string;
-    appToken?: string;
-}
-/** A provider option for Clack select prompts. */
-export interface ProviderChoice {
-    value: string;
-    label: string;
-    hint?: string;
-}
-/** Provider options for Clack select prompts. */
-export declare const PROVIDERS: ProviderChoice[];
-/** Minimum API key lengths per provider (0 = no key needed). */
-export declare const MIN_KEY_LENGTHS: Record<string, number>;
-/** Map provider name to the environment variable key for the API key. */
-export declare const PROVIDER_ENV_KEYS: Record<string, string>;
-/** Map channel type to required credential environment variable names. */
-export declare const CHANNEL_ENV_KEYS: Record<string, string[]>;
-/** All supported channel types for Clack multiselect. */
-export declare const CHANNEL_TYPES: {
-    value: ChannelSetup["type"];
-    label: string;
-}[];

package/node_modules/@comis/cli/dist/wizard/flow-types.js

@@ -1,70 +0,0 @@
-// SPDX-License-Identifier: Apache-2.0
-/**
- * Shared types and constants for the init wizard flows.
- *
- * Provides the WizardResult, ChannelSetup, and ProviderChoice types
- * used by both QuickStart and Manual flows, plus constant arrays
- * for providers, channel types, and minimum key lengths.
- *
- * @module
- */
-// ---------- Constants ----------
-/** Provider options for Clack select prompts. */
-export const PROVIDERS = [
-    { value: "anthropic", label: "Anthropic (Claude)", hint: "Recommended" },
-    { value: "openai", label: "OpenAI (GPT)" },
-    { value: "google", label: "Google (Gemini)" },
-    { value: "groq", label: "Groq", hint: "Fast inference" },
-    { value: "mistral", label: "Mistral" },
-    { value: "deepseek", label: "DeepSeek" },
-    { value: "xai", label: "xAI (Grok)" },
-    { value: "together", label: "Together AI" },
-    { value: "cerebras", label: "Cerebras", hint: "Fast inference" },
-    { value: "openrouter", label: "OpenRouter", hint: "Multi-provider gateway" },
-    { value: "ollama", label: "Ollama (local)", hint: "No API key needed" },
-];
-/** Minimum API key lengths per provider (0 = no key needed). */
-export const MIN_KEY_LENGTHS = {
-    anthropic: 20,
-    openai: 20,
-    google: 20,
-    groq: 20,
-    mistral: 20,
-    deepseek: 20,
-    xai: 20,
-    together: 20,
-    cerebras: 20,
-    openrouter: 20,
-    ollama: 0,
-};
-/** Map provider name to the environment variable key for the API key. */
-export const PROVIDER_ENV_KEYS = {
-    anthropic: "ANTHROPIC_API_KEY",
-    openai: "OPENAI_API_KEY",
-    google: "GOOGLE_API_KEY",
-    groq: "GROQ_API_KEY",
-    mistral: "MISTRAL_API_KEY",
-    deepseek: "DEEPSEEK_API_KEY",
-    xai: "XAI_API_KEY",
-    together: "TOGETHER_API_KEY",
-    cerebras: "CEREBRAS_API_KEY",
-    openrouter: "OPENROUTER_API_KEY",
-};
-/** Map channel type to required credential environment variable names. */
-export const CHANNEL_ENV_KEYS = {
-    telegram: ["TELEGRAM_BOT_TOKEN"],
-    discord: ["DISCORD_BOT_TOKEN"],
-    slack: ["SLACK_BOT_TOKEN", "SLACK_SIGNING_SECRET"],
-    whatsapp: ["WHATSAPP_ACCESS_TOKEN", "WHATSAPP_VERIFY_TOKEN"],
-    line: ["LINE_CHANNEL_ACCESS_TOKEN", "LINE_CHANNEL_SECRET"],
-};
-/** All supported channel types for Clack multiselect. */
-export const CHANNEL_TYPES = [
-    { value: "telegram", label: "Telegram" },
-    { value: "discord", label: "Discord" },
-    { value: "slack", label: "Slack" },
-    { value: "whatsapp", label: "WhatsApp" },
-    { value: "signal", label: "Signal" },
-    { value: "irc", label: "IRC" },
-    { value: "line", label: "LINE" },
-];

package/node_modules/@comis/cli/dist/wizard/manual-flow.d.ts

@@ -1,21 +0,0 @@
-/**
- * Manual wizard flow.
- *
- * Full-control wizard covering all 8 steps: provider, API key,
- * agent name, model, channels, gateway, data directory, and review.
- * Uses ModelCatalog from @comis/agent for dynamic model selection.
- *
- * @module
- */
-import { type Result } from "@comis/shared";
-import type { WizardResult } from "./flow-types.js";
-/**
- * Run the Manual wizard flow.
- *
- * Presents all configuration options: provider, API key, agent name,
- * model, channels, gateway, data directory, and a review step.
- *
- * @param configDir - Override config directory (default ~/.comis)
- * @returns The wizard result or an error
- */
-export declare function runManualFlow(configDir?: string): Promise<Result<WizardResult, Error>>;

package/node_modules/@comis/cli/dist/wizard/manual-flow.js

@@ -1,345 +0,0 @@
-// SPDX-License-Identifier: Apache-2.0
-/**
- * Manual wizard flow.
- *
- * Full-control wizard covering all 8 steps: provider, API key,
- * agent name, model, channels, gateway, data directory, and review.
- * Uses ModelCatalog from @comis/agent for dynamic model selection.
- *
- * @module
- */
-import * as p from "@clack/prompts";
-import { randomBytes } from "node:crypto";
-import * as os from "node:os";
-import { ok, err } from "@comis/shared";
-import { createModelCatalog } from "@comis/agent";
-import { PROVIDERS, MIN_KEY_LENGTHS, CHANNEL_TYPES, } from "./flow-types.js";
-import { writeWizardConfig, writeWizardEnv } from "./config-writer.js";
-/**
- * Run the Manual wizard flow.
- *
- * Presents all configuration options: provider, API key, agent name,
- * model, channels, gateway, data directory, and a review step.
- *
- * @param configDir - Override config directory (default ~/.comis)
- * @returns The wizard result or an error
- */
-export async function runManualFlow(configDir) {
-    const targetDir = configDir ?? os.homedir() + "/.comis";
-    p.intro("Comis Manual Setup");
-    // Step 1: Provider
-    const provider = await p.select({
-        message: "Select your LLM provider:",
-        options: PROVIDERS,
-    });
-    if (p.isCancel(provider)) {
-        p.cancel("Setup cancelled.");
-        process.exit(0);
-    }
-    // Step 2: API key
-    let apiKey = "";
-    if (provider !== "ollama") {
-        const minLen = MIN_KEY_LENGTHS[provider] ?? 20;
-        const keyResult = await p.password({
-            message: `Enter your ${provider} API key:`,
-            validate: (value) => {
-                if (!value || value.length < minLen) {
-                    return `API key must be at least ${minLen} characters`;
-                }
-                return undefined;
-            },
-        });
-        if (p.isCancel(keyResult)) {
-            p.cancel("Setup cancelled.");
-            process.exit(0);
-        }
-        apiKey = keyResult;
-    }
-    else {
-        p.log.info("Ollama runs locally -- no API key needed.");
-    }
-    // Step 3: Agent name
-    const agentName = await p.text({
-        message: "Name your agent:",
-        placeholder: "Comis",
-        defaultValue: "Comis",
-        validate: (value) => {
-            if (!value || !/^[a-zA-Z0-9][a-zA-Z0-9-]*$/.test(value)) {
-                return "Name must be alphanumeric with optional hyphens (no leading hyphen)";
-            }
-            if (value.length > 64) {
-                return "Name must be at most 64 characters";
-            }
-            return undefined;
-        },
-    });
-    if (p.isCancel(agentName)) {
-        p.cancel("Setup cancelled.");
-        process.exit(0);
-    }
-    // Step 4: Model selection from ModelCatalog
-    let model;
-    try {
-        const catalog = createModelCatalog();
-        catalog.loadStatic();
-        const models = catalog.getByProvider(provider);
-        if (models.length > 0) {
-            const modelOptions = models.slice(0, 20).map((m) => ({
-                value: m.modelId,
-                label: m.displayName,
-                hint: m.contextWindow > 0 ? `${Math.round(m.contextWindow / 1000)}k ctx` : undefined,
-            }));
-            // Add custom option
-            modelOptions.push({ value: "__custom__", label: "Custom (enter manually)", hint: undefined });
-            const modelChoice = await p.select({
-                message: "Select a model:",
-                options: modelOptions,
-            });
-            if (p.isCancel(modelChoice)) {
-                p.cancel("Setup cancelled.");
-                process.exit(0);
-            }
-            if (modelChoice === "__custom__") {
-                const custom = await p.text({
-                    message: "Enter custom model identifier:",
-                    validate: (value) => !value || value.length === 0
-                        ? "Model identifier is required"
-                        : undefined,
-                });
-                if (p.isCancel(custom)) {
-                    p.cancel("Setup cancelled.");
-                    process.exit(0);
-                }
-                model = custom;
-            }
-            else {
-                model = modelChoice;
-            }
-        }
-        else {
-            const custom = await p.text({
-                message: "Enter model identifier:",
-                placeholder: getDefaultModel(provider),
-                defaultValue: getDefaultModel(provider),
-            });
-            if (p.isCancel(custom)) {
-                p.cancel("Setup cancelled.");
-                process.exit(0);
-            }
-            model = custom;
-        }
-    }
-    catch {
-        // Fallback if ModelCatalog fails
-        const custom = await p.text({
-            message: "Enter model identifier:",
-            placeholder: getDefaultModel(provider),
-            defaultValue: getDefaultModel(provider),
-        });
-        if (p.isCancel(custom)) {
-            p.cancel("Setup cancelled.");
-            process.exit(0);
-        }
-        model = custom;
-    }
-    // Step 5: Channels
-    const channels = [];
-    const setupChannels = await p.confirm({
-        message: "Would you like to configure messaging channels?",
-        initialValue: false,
-    });
-    if (p.isCancel(setupChannels)) {
-        p.cancel("Setup cancelled.");
-        process.exit(0);
-    }
-    if (setupChannels) {
-        const selectedTypes = await p.multiselect({
-            message: "Select channels to configure:",
-            options: CHANNEL_TYPES,
-            required: false,
-        });
-        if (p.isCancel(selectedTypes)) {
-            p.cancel("Setup cancelled.");
-            process.exit(0);
-        }
-        for (const channelType of selectedTypes) {
-            const setup = { type: channelType };
-            if (channelType === "telegram") {
-                const token = await p.password({
-                    message: "Telegram bot token (from @BotFather):",
-                    validate: (v) => !v || v.length < 10 ? "Token too short" : undefined,
-                });
-                if (p.isCancel(token)) {
-                    p.cancel("Setup cancelled.");
-                    process.exit(0);
-                }
-                setup.botToken = token;
-            }
-            else if (channelType === "discord") {
-                const token = await p.password({
-                    message: "Discord bot token:",
-                    validate: (v) => !v || v.length < 10 ? "Token too short" : undefined,
-                });
-                if (p.isCancel(token)) {
-                    p.cancel("Setup cancelled.");
-                    process.exit(0);
-                }
-                setup.botToken = token;
-            }
-            else if (channelType === "slack") {
-                const botToken = await p.password({
-                    message: "Slack bot token (xoxb-...):",
-                    validate: (v) => !v || v.length < 10 ? "Token too short" : undefined,
-                });
-                if (p.isCancel(botToken)) {
-                    p.cancel("Setup cancelled.");
-                    process.exit(0);
-                }
-                setup.botToken = botToken;
-                const appToken = await p.password({
-                    message: "Slack app token (xapp-...):",
-                    validate: (v) => !v || v.length < 10 ? "Token too short" : undefined,
-                });
-                if (p.isCancel(appToken)) {
-                    p.cancel("Setup cancelled.");
-                    process.exit(0);
-                }
-                setup.appToken = appToken;
-            }
-            else if (channelType === "whatsapp") {
-                p.log.info("WhatsApp uses QR code pairing -- no token needed during setup.");
-            }
-            else if (channelType === "signal") {
-                p.log.info("Signal requires signal-cli. Run 'comis signal-setup' after init.");
-            }
-            else if (channelType === "irc" || channelType === "line") {
-                p.log.info(`${channelType.toUpperCase()} adapter will use default configuration.`);
-            }
-            channels.push(setup);
-        }
-    }
-    // Step 6: Gateway
-    let gatewayEnabled = false;
-    let gatewayHost = "127.0.0.1";
-    let gatewayPort = 3000;
-    let gatewayToken;
-    const enableGateway = await p.confirm({
-        message: "Enable the gateway HTTP server (web dashboard & API)?",
-        initialValue: true,
-    });
-    if (p.isCancel(enableGateway)) {
-        p.cancel("Setup cancelled.");
-        process.exit(0);
-    }
-    if (enableGateway) {
-        gatewayEnabled = true;
-        const host = await p.text({
-            message: "Gateway bind address:",
-            defaultValue: "127.0.0.1",
-            placeholder: "127.0.0.1",
-        });
-        if (p.isCancel(host)) {
-            p.cancel("Setup cancelled.");
-            process.exit(0);
-        }
-        gatewayHost = host;
-        const portStr = await p.text({
-            message: "Gateway port:",
-            defaultValue: "3000",
-            placeholder: "3000",
-            validate: (value) => {
-                const num = Number(value);
-                if (!Number.isInteger(num) || num < 1 || num > 65535) {
-                    return "Port must be an integer between 1 and 65535";
-                }
-                return undefined;
-            },
-        });
-        if (p.isCancel(portStr)) {
-            p.cancel("Setup cancelled.");
-            process.exit(0);
-        }
-        gatewayPort = Number(portStr);
-        gatewayToken = randomBytes(32).toString("hex");
-        p.log.info("Generated gateway access token for authentication.");
-    }
-    // Step 7: Data directory
-    const dataDir = await p.text({
-        message: "Data directory for persistent storage:",
-        defaultValue: targetDir,
-        placeholder: targetDir,
-        validate: (value) => {
-            if (!value)
-                return "Path is required";
-            if (!value.startsWith("/") && !value.startsWith("./") && !value.startsWith("~/")) {
-                return "Please provide an absolute path, or relative with ./ or ~/";
-            }
-            return undefined;
-        },
-    });
-    if (p.isCancel(dataDir)) {
-        p.cancel("Setup cancelled.");
-        process.exit(0);
-    }
-    // Step 8: Review
-    const summary = [
-        `  Provider:   ${provider}`,
-        `  API Key:    ${apiKey ? "****" + apiKey.slice(-4) : "(none)"}`,
-        `  Agent Name: ${agentName}`,
-        `  Model:      ${model}`,
-        `  Channels:   ${channels.length > 0 ? channels.map((c) => c.type).join(", ") : "(none)"}`,
-        `  Gateway:    ${gatewayEnabled ? `${gatewayHost}:${gatewayPort}` : "disabled"}`,
-        `  Data Dir:   ${dataDir}`,
-    ].join("\n");
-    p.log.info("Configuration summary:\n" + summary);
-    const confirmed = await p.confirm({
-        message: "Save this configuration?",
-        initialValue: true,
-    });
-    if (p.isCancel(confirmed) || !confirmed) {
-        p.cancel("Setup cancelled. No files written.");
-        process.exit(0);
-    }
-    const wizardResult = {
-        provider,
-        apiKey,
-        agentName,
-        model,
-        channels,
-        gatewayEnabled,
-        gatewayHost,
-        gatewayPort,
-        gatewayToken,
-        dataDir,
-    };
-    // Write config files
-    const configResult = writeWizardConfig(wizardResult, targetDir);
-    if (!configResult.ok) {
-        p.log.error(`Failed to write config: ${configResult.error.message}`);
-        return err(configResult.error);
-    }
-    if (apiKey) {
-        const envResult = writeWizardEnv(wizardResult, targetDir);
-        if (!envResult.ok) {
-            p.log.error(`Failed to write .env: ${envResult.error.message}`);
-            return err(envResult.error);
-        }
-    }
-    p.log.success(`Configuration saved to ${configResult.value}`);
-    if (gatewayEnabled && gatewayToken) {
-        p.log.warn(`Save your gateway token -- it will not be shown again:\n  ${gatewayToken}`);
-    }
-    p.outro("Setup complete! Next: comis daemon start");
-    return ok(wizardResult);
-}
-/** Fallback default model per provider. */
-function getDefaultModel(provider) {
-    const defaults = {
-        anthropic: "claude-sonnet-4-5-20250929",
-        openai: "gpt-4o",
-        google: "gemini-2.0-flash",
-        groq: "llama-3.3-70b-versatile",
-        ollama: "llama3",
-    };
-    return defaults[provider] ?? "default";
-}

package/node_modules/@comis/cli/dist/wizard/quickstart-flow.d.ts

@@ -1,21 +0,0 @@
-/**
- * QuickStart wizard flow.
- *
- * Collects provider, API key, and agent name in 3 prompts (skipping
- * API key for Ollama). Uses ModelCatalog from @comis/agent for
- * dynamic model selection instead of hardcoded lists.
- *
- * @module
- */
-import { type Result } from "@comis/shared";
-import type { WizardResult } from "./flow-types.js";
-/**
- * Run the QuickStart wizard flow.
- *
- * Collects provider + API key + agent name, picks the first model
- * from ModelCatalog for the provider, writes config and .env.
- *
- * @param configDir - Override config directory (default ~/.comis)
- * @returns The wizard result or an error
- */
-export declare function runQuickStartFlow(configDir?: string): Promise<Result<WizardResult, Error>>;

package/node_modules/@comis/cli/dist/wizard/quickstart-flow.js

@@ -1,116 +0,0 @@
-// SPDX-License-Identifier: Apache-2.0
-/**
- * QuickStart wizard flow.
- *
- * Collects provider, API key, and agent name in 3 prompts (skipping
- * API key for Ollama). Uses ModelCatalog from @comis/agent for
- * dynamic model selection instead of hardcoded lists.
- *
- * @module
- */
-import * as p from "@clack/prompts";
-import * as os from "node:os";
-import { ok, err } from "@comis/shared";
-import { createModelCatalog } from "@comis/agent";
-import { PROVIDERS, MIN_KEY_LENGTHS } from "./flow-types.js";
-import { writeWizardConfig, writeWizardEnv } from "./config-writer.js";
-/**
- * Run the QuickStart wizard flow.
- *
- * Collects provider + API key + agent name, picks the first model
- * from ModelCatalog for the provider, writes config and .env.
- *
- * @param configDir - Override config directory (default ~/.comis)
- * @returns The wizard result or an error
- */
-export async function runQuickStartFlow(configDir) {
-    const targetDir = configDir ?? os.homedir() + "/.comis";
-    p.intro("Comis Quick Setup");
-    const result = await p.group({
-        provider: () => p.select({
-            message: "Select your LLM provider:",
-            options: PROVIDERS,
-        }),
-        apiKey: ({ results }) => {
-            if (results.provider === "ollama") {
-                p.log.info("Ollama runs locally -- no API key needed.");
-                return Promise.resolve("");
-            }
-            const minLen = MIN_KEY_LENGTHS[results.provider] ?? 20;
-            return p.password({
-                message: `Enter your ${results.provider} API key:`,
-                validate: (value) => {
-                    if (!value || value.length < minLen) {
-                        return `API key must be at least ${minLen} characters`;
-                    }
-                    return undefined;
-                },
-            });
-        },
-        agentName: () => p.text({
-            message: "Name your agent:",
-            placeholder: "Comis",
-            defaultValue: "Comis",
-            validate: (value) => {
-                if (!value || !/^[a-zA-Z0-9][a-zA-Z0-9-]*$/.test(value)) {
-                    return "Name must be alphanumeric with optional hyphens (no leading hyphen)";
-                }
-                if (value.length > 64) {
-                    return "Name must be at most 64 characters";
-                }
-                return undefined;
-            },
-        }),
-    }, {
-        onCancel: () => {
-            p.cancel("Setup cancelled.");
-            process.exit(0);
-        },
-    });
-    // Use ModelCatalog for dynamic model selection
-    let model;
-    try {
-        const catalog = createModelCatalog();
-        catalog.loadStatic();
-        const models = catalog.getByProvider(result.provider);
-        model = models.length > 0 ? models[0].modelId : getDefaultModel(result.provider);
-    }
-    catch {
-        // Fallback if pi-ai loading fails
-        model = getDefaultModel(result.provider);
-    }
-    const wizardResult = {
-        provider: result.provider,
-        apiKey: result.apiKey,
-        agentName: result.agentName,
-        model,
-        dataDir: targetDir,
-    };
-    // Write config files
-    const configResult = writeWizardConfig(wizardResult, targetDir);
-    if (!configResult.ok) {
-        p.log.error(`Failed to write config: ${configResult.error.message}`);
-        return err(configResult.error);
-    }
-    if (wizardResult.apiKey) {
-        const envResult = writeWizardEnv(wizardResult, targetDir);
-        if (!envResult.ok) {
-            p.log.error(`Failed to write .env: ${envResult.error.message}`);
-            return err(envResult.error);
-        }
-    }
-    p.log.success(`Configuration saved to ${configResult.value}`);
-    p.outro("Setup complete! Next: comis daemon start");
-    return ok(wizardResult);
-}
-/** Fallback default model per provider. */
-function getDefaultModel(provider) {
-    const defaults = {
-        anthropic: "claude-sonnet-4-5-20250929",
-        openai: "gpt-4o",
-        google: "gemini-2.0-flash",
-        groq: "llama-3.3-70b-versatile",
-        ollama: "llama3",
-    };
-    return defaults[provider] ?? "default";
-}