hoomanjs 1.46.0 → 1.55.0

package/dist/core/utils/onboarding-config.js

@@ -0,0 +1,373 @@
+/**
+ * Shared first-run onboarding: validate inference + search credentials and
+ * write `~/.hooman/config.json`. Used by the CLI Ink flow and the VS Code
+ * webview onboarding.
+ */
+import { existsSync, mkdirSync, writeFileSync } from "node:fs";
+import { dirname } from "node:path";
+import { DEFAULT_PREFETCH_MODEL_BY_PROVIDER, resolvePrefetchModels, } from "./models-prefetch.js";
+import { probeSearchProvider, } from "./search-probe.js";
+import { configJsonPath } from "./paths.js";
+export const ONBOARDING_PROVIDER_LABELS = {
+    anthropic: "Anthropic",
+    azure: "Azure OpenAI",
+    bedrock: "Bedrock",
+    google: "Google",
+    groq: "Groq",
+    "llama-cpp": "llama.cpp",
+    minimax: "MiniMax",
+    mlx: "mlx",
+    moonshot: "Moonshot",
+    ollama: "Ollama",
+    openai: "OpenAI",
+    openrouter: "OpenRouter",
+    xai: "xAI",
+};
+export const ONBOARDING_SEARCH_LABELS = {
+    brave: "Brave",
+    duckduckgo: "DuckDuckGo",
+    exa: "Exa",
+    firecrawl: "Firecrawl",
+    litellm: "LiteLLM",
+    serper: "Serper",
+    tavily: "Tavily",
+};
+/** Inference providers offered during first-run onboarding. */
+export const ONBOARDING_PROVIDERS = [
+    "llama-cpp",
+    "mlx",
+    "ollama",
+    "anthropic",
+    "openai",
+    "google",
+    "azure",
+    "bedrock",
+    "groq",
+    "minimax",
+    "moonshot",
+    "openrouter",
+    "xai",
+];
+/** Search providers offered during first-run onboarding. */
+export const ONBOARDING_SEARCH_PROVIDERS = [
+    "duckduckgo",
+    "brave",
+    "exa",
+    "firecrawl",
+    "litellm",
+    "serper",
+    "tavily",
+];
+/** True when `~/.hooman/config.json` (or `HOOMAN_HOME`) already exists. */
+export function hasOnboardingConfig(path = configJsonPath()) {
+    return existsSync(path);
+}
+export function onboardingProviderFields(provider) {
+    switch (provider) {
+        case "llama-cpp":
+        case "mlx":
+            return [];
+        case "ollama":
+            return [
+                {
+                    key: "baseURL",
+                    label: "Base URL",
+                    placeholder: "http://127.0.0.1:11434",
+                },
+            ];
+        case "azure":
+            return [
+                {
+                    key: "baseURL",
+                    label: "Base URL",
+                    placeholder: "https://your-resource.openai.azure.com/openai",
+                    required: true,
+                },
+                {
+                    key: "apiKey",
+                    label: "API key",
+                    placeholder: "...",
+                    sensitive: true,
+                    required: true,
+                },
+                {
+                    key: "deployment",
+                    label: "Deployment name",
+                    placeholder: "gpt-5.4-mini",
+                    required: true,
+                },
+            ];
+        case "bedrock":
+            return [
+                {
+                    key: "region",
+                    label: "Region",
+                    placeholder: "us-west-2",
+                    required: true,
+                },
+                {
+                    key: "profile",
+                    label: "AWS profile",
+                    placeholder: "default",
+                    required: true,
+                },
+            ];
+        default:
+            return [
+                {
+                    key: "apiKey",
+                    label: "API key",
+                    placeholder: "...",
+                    sensitive: true,
+                    required: true,
+                },
+            ];
+    }
+}
+export function onboardingSearchFields(provider) {
+    if (provider === "duckduckgo") {
+        return [];
+    }
+    if (provider === "litellm") {
+        return [
+            {
+                key: "baseURL",
+                label: "Base URL",
+                placeholder: "http://localhost:4000",
+                required: true,
+            },
+            {
+                key: "apiKey",
+                label: "API key",
+                placeholder: "...",
+                sensitive: true,
+                required: true,
+            },
+            {
+                key: "tool",
+                label: "Tool",
+                placeholder: "perplexity-search",
+                required: true,
+            },
+        ];
+    }
+    return [
+        {
+            key: "apiKey",
+            label: "API key",
+            placeholder: "...",
+            sensitive: true,
+            required: true,
+        },
+    ];
+}
+export function initialOnboardingProviderValues(provider) {
+    if (provider === "bedrock") {
+        return { region: "us-west-2", profile: "default" };
+    }
+    return {};
+}
+/** Validate provider credentials via the list endpoint (throws on failure). */
+export async function validateOnboardingProvider(input) {
+    await resolvePrefetchModels({
+        provider: input.provider,
+        apiKey: input.providerOptions.apiKey,
+        baseURL: input.providerOptions.baseURL,
+        region: input.providerOptions.region,
+        accessKeyId: input.providerOptions.accessKeyId,
+        secretAccessKey: input.providerOptions.secretAccessKey,
+        azureDeployment: input.azureDeployment?.trim(),
+    });
+}
+/** Probe the selected search provider with a one-result test query. */
+export async function validateOnboardingSearch(provider, options) {
+    await probeSearchProvider({
+        provider,
+        apiKey: options.apiKey,
+        baseURL: options.baseURL,
+        tool: options.tool,
+    });
+}
+/**
+ * Validate inference + search credentials, then write config.json.
+ * `configPath` defaults to {@link configJsonPath}.
+ */
+export async function completeOnboardingConfig(input, onStatus, configPath = configJsonPath()) {
+    onStatus?.("listing", "Validating credentials…");
+    const azureDeployment = input.azureDeployment?.trim();
+    let models;
+    try {
+        models = await resolvePrefetchModels({
+            provider: input.provider,
+            apiKey: input.providerOptions.apiKey,
+            baseURL: input.providerOptions.baseURL,
+            region: input.providerOptions.region,
+            accessKeyId: input.providerOptions.accessKeyId,
+            secretAccessKey: input.providerOptions.secretAccessKey,
+            azureDeployment,
+        });
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        throw new Error(`Could not validate credentials for ${ONBOARDING_PROVIDER_LABELS[input.provider]}: ${detail}`);
+    }
+    onStatus?.("listing", "Validating search…");
+    try {
+        await validateOnboardingSearch(input.searchProvider, input.searchOptions);
+    }
+    catch (error) {
+        const detail = error instanceof Error ? error.message : String(error);
+        throw new Error(`Could not validate ${ONBOARDING_SEARCH_LABELS[input.searchProvider]} search: ${detail}`);
+    }
+    onStatus?.("writing", "Writing config…");
+    const config = buildHomeConfig(input, models);
+    mkdirSync(dirname(configPath), { recursive: true });
+    writeFileSync(configPath, `${JSON.stringify(config, null, 2)}\n`, "utf8");
+}
+function buildHomeConfig(input, models) {
+    const displayName = ONBOARDING_PROVIDER_LABELS[input.provider];
+    const providerOptions = buildProviderOptions(input);
+    const search = buildSearchBlock(input.searchProvider, input.searchOptions);
+    const fallback = {
+        id: DEFAULT_PREFETCH_MODEL_BY_PROVIDER[input.provider],
+        displayName: DEFAULT_PREFETCH_MODEL_BY_PROVIDER[input.provider],
+    };
+    const list = models.length > 0 ? models : [fallback];
+    const usedNames = new Set();
+    const llms = list.map((model, index) => {
+        const entry = {
+            name: uniqueLlmName(model.displayName, model.id, usedNames),
+            provider: displayName,
+            options: { model: model.id },
+            metadata: { name: model.id },
+            default: index === 0,
+        };
+        if (input.provider === "llama-cpp" || input.provider === "mlx") {
+            const context = model.id.toLowerCase().includes("qwen") ? 262144 : 131072;
+            entry.options.context = context;
+        }
+        return entry;
+    });
+    return {
+        name: "Hooman",
+        providers: [
+            {
+                name: displayName,
+                provider: input.provider,
+                options: providerOptions,
+            },
+        ],
+        llms,
+        search,
+        prompts: {
+            behaviour: true,
+            communication: true,
+            execution: true,
+            guardrails: true,
+        },
+        tools: {
+            todo: { enabled: true },
+            fetch: { enabled: true },
+            filesystem: { enabled: true },
+            shell: { enabled: true },
+            sleep: { enabled: true },
+            browser: { enabled: true },
+            subagents: { enabled: true },
+        },
+        compaction: { ratio: 0.75, keep: 5 },
+        reasoning: "collapsed",
+    };
+}
+function uniqueLlmName(displayName, id, used) {
+    const base = displayName.trim() || id;
+    if (!used.has(base)) {
+        used.add(base);
+        return base;
+    }
+    const withId = `${base} (${id})`;
+    if (!used.has(withId)) {
+        used.add(withId);
+        return withId;
+    }
+    let n = 2;
+    while (used.has(`${base} (${n})`)) {
+        n += 1;
+    }
+    const name = `${base} (${n})`;
+    used.add(name);
+    return name;
+}
+function buildProviderOptions(input) {
+    const opts = {};
+    const raw = input.providerOptions;
+    switch (input.provider) {
+        case "llama-cpp":
+            break;
+        case "mlx":
+            opts.promptCache = {};
+            break;
+        case "ollama": {
+            const baseURL = raw.baseURL?.trim();
+            if (baseURL) {
+                opts.baseURL = baseURL;
+            }
+            break;
+        }
+        case "azure": {
+            const baseURL = raw.baseURL?.trim();
+            const apiKey = raw.apiKey?.trim();
+            if (baseURL) {
+                opts.baseURL = baseURL;
+            }
+            if (apiKey) {
+                opts.apiKey = apiKey;
+            }
+            break;
+        }
+        case "bedrock": {
+            const region = raw.region?.trim() || "us-west-2";
+            const profile = raw.profile?.trim() || "default";
+            opts.region = region;
+            opts.profile = profile;
+            break;
+        }
+        default: {
+            const apiKey = raw.apiKey?.trim();
+            if (apiKey) {
+                opts.apiKey = apiKey;
+            }
+            break;
+        }
+    }
+    return opts;
+}
+function buildSearchBlock(provider, options) {
+    const block = {
+        enabled: true,
+        provider,
+        brave: {},
+        duckduckgo: {},
+        exa: {},
+        firecrawl: {},
+        litellm: {},
+        serper: {},
+        tavily: {},
+    };
+    if (provider === "duckduckgo") {
+        return block;
+    }
+    if (provider === "litellm") {
+        block.litellm = {
+            ...(options.baseURL?.trim() ? { baseURL: options.baseURL.trim() } : {}),
+            ...(options.apiKey?.trim() ? { apiKey: options.apiKey.trim() } : {}),
+            ...(options.tool?.trim() ? { tool: options.tool.trim() } : {}),
+        };
+        return block;
+    }
+    const apiKey = options.apiKey?.trim();
+    if (apiKey) {
+        block[provider] = { apiKey };
+    }
+    return block;
+}
+//# sourceMappingURL=onboarding-config.js.map

package/dist/core/utils/onboarding-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"onboarding-config.js","sourceRoot":"","sources":["../../../src/core/utils/onboarding-config.ts"],"names":[],"mappings":"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"}

package/dist/core/utils/paths.d.ts

@@ -1,17 +1,19 @@
 export declare const APP_FOLDER = ".hooman";
+export declare const allowlistJsonPath: () => string;
+export declare const attachmentsPath: () => string;
 export declare const basePath: () => string;
+export declare const binPath: () => string;
+export declare const cachePath: () => string;
 export declare const configJsonPath: () => string;
+/** Workspace-local design artifacts: `<cwd>/.hooman/design/<slug>/`. */
+export declare const designArtifactsPath: (cwd?: string) => string;
 export declare const instructionsMdPath: () => string;
+export declare const localSkillsPath: (cwd?: string) => string;
 export declare const mcpJsonPath: () => string;
 export declare const mcpOauthJsonPath: () => string;
-export declare const allowlistJsonPath: () => string;
-export declare const sessionsPath: () => string;
 export declare const memoryPath: () => string;
 export declare const offloadedContentPath: () => string;
-export declare const attachmentsPath: () => string;
 export declare const plansPath: () => string;
-export declare const skillsPath: () => string;
-export declare const localSkillsPath: (cwd?: string) => string;
-export declare const cachePath: () => string;
-export declare const binPath: () => string;
 export declare const ripgrepPath: () => string;
+export declare const sessionsPath: () => string;
+export declare const skillsPath: () => string;

package/dist/core/utils/paths.js

@@ -4,6 +4,11 @@ import { getCwd } from "./cwd-context.js";
 import { projectPath } from "./project-registry.js";
 export const APP_FOLDER = ".hooman";
 const HOOMAN_HOME_ENV = "HOOMAN_HOME";
+export const allowlistJsonPath = () => join(basePath(), "allowlist.json");
+// Per-project storage: scoped to the current working directory's project via a
+// UUID registry (see ./project-registry.ts), so sessions, memory, attachments,
+// and plans do not bleed across unrelated projects.
+export const attachmentsPath = () => join(projectPath(), "attachments");
 export const basePath = () => {
     const override = process.env[HOOMAN_HOME_ENV]?.trim();
     if (override) {
@@ -11,22 +16,19 @@ export const basePath = () => {
     }
     return join(homedir(), APP_FOLDER);
 };
+export const binPath = () => join(basePath(), "bin");
+export const cachePath = () => join(basePath(), "cache");
 export const configJsonPath = () => join(basePath(), "config.json");
+/** Workspace-local design artifacts: `<cwd>/.hooman/design/<slug>/`. */
+export const designArtifactsPath = (cwd = getCwd()) => join(cwd, APP_FOLDER, "design");
 export const instructionsMdPath = () => join(basePath(), "instructions.md");
+export const localSkillsPath = (cwd = getCwd()) => join(cwd, APP_FOLDER, "skills");
 export const mcpJsonPath = () => join(basePath(), "mcp.json");
 export const mcpOauthJsonPath = () => join(basePath(), "mcp-oauth.json");
-export const allowlistJsonPath = () => join(basePath(), "allowlist.json");
-// Per-project storage: scoped to the current working directory's project via a
-// UUID registry (see ./project-registry.ts), so sessions, memory, attachments,
-// and plans do not bleed across unrelated projects.
-export const sessionsPath = () => join(projectPath(), "sessions");
 export const memoryPath = () => join(projectPath(), "memory");
 export const offloadedContentPath = () => join(projectPath(), "offloaded-content");
-export const attachmentsPath = () => join(projectPath(), "attachments");
 export const plansPath = () => join(projectPath(), "plans");
-export const skillsPath = () => join(basePath(), "skills");
-export const localSkillsPath = (cwd = getCwd()) => join(cwd, APP_FOLDER, "skills");
-export const cachePath = () => join(basePath(), "cache");
-export const binPath = () => join(basePath(), "bin");
 export const ripgrepPath = () => join(binPath(), process.platform === "win32" ? "rg.exe" : "rg");
+export const sessionsPath = () => join(projectPath(), "sessions");
+export const skillsPath = () => join(basePath(), "skills");
 //# sourceMappingURL=paths.js.map

package/dist/core/utils/paths.js.map

@@ -1 +1 @@
-{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/core/utils/paths.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,IAAI,CAAC;AAC7B,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,MAAM,CAAC,MAAM,UAAU,GAAG,SAAS,CAAC;AACpC,MAAM,eAAe,GAAG,aAAa,CAAC;AAEtC,MAAM,CAAC,MAAM,QAAQ,GAAG,GAAG,EAAE;IAC3B,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,IAAI,EAAE,CAAC;IACtD,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,OAAO,IAAI,CAAC,OAAO,EAAE,EAAE,UAAU,CAAC,CAAC;AACrC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,aAAa,CAAC,CAAC;AAEpE,MAAM,CAAC,MAAM,kBAAkB,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,iBAAiB,CAAC,CAAC;AAE5E,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,UAAU,CAAC,CAAC;AAE9D,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,gBAAgB,CAAC,CAAC;AAEzE,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,gBAAgB,CAAC,CAAC;AAE1E,+EAA+E;AAC/E,+EAA+E;AAC/E,oDAAoD;AACpD,MAAM,CAAC,MAAM,YAAY,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,UAAU,CAAC,CAAC;AAElE,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,QAAQ,CAAC,CAAC;AAE9D,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAG,EAAE,CACvC,IAAI,CAAC,WAAW,EAAE,EAAE,mBAAmB,CAAC,CAAC;AAE3C,MAAM,CAAC,MAAM,eAAe,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,aAAa,CAAC,CAAC;AAExE,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,EAAE,OAAO,CAAC,CAAC;AAE5D,MAAM,CAAC,MAAM,UAAU,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,QAAQ,CAAC,CAAC;AAE3D,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,MAAc,MAAM,EAAE,EAAE,EAAE,CACxD,IAAI,CAAC,GAAG,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;AAElC,MAAM,CAAC,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;AAEzD,MAAM,CAAC,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,KAAK,CAAC,CAAC;AAErD,MAAM,CAAC,MAAM,WAAW,GAAG,GAAG,EAAE,CAC9B,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC"}
+{"version":3,"file":"paths.js","sourceRoot":"","sources":["../../../src/core/utils/paths.ts"],"names":[],"mappings":"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"}

package/dist/core/utils/preview-server.d.ts

@@ -0,0 +1,20 @@
+export type PreviewServer = {
+    rootDir: string;
+    port: number;
+    baseUrl: string;
+    /** Absolute URL for a file under the server root. */
+    urlFor(filePath: string): string;
+    close(): Promise<void>;
+};
+/**
+ * Start a localhost static file server with SSE live-reload.
+ * Servers are keyed by absolute `rootDir`; calling again for the same root
+ * returns the existing server.
+ *
+ * @param rootDir Absolute directory to serve.
+ * @param port Bind port; `0` (default) picks an ephemeral free port.
+ */
+export declare function createPreviewServer(rootDirRaw: string, port?: number): Promise<PreviewServer>;
+export declare function getPreviewServer(rootDirRaw: string): PreviewServer | undefined;
+export declare function stopPreviewServer(rootDirRaw: string): Promise<boolean>;
+export declare function listPreviewServerRoots(): string[];