@marcopeg/hal 1.0.32 → 1.0.34

package/dist/wizard/steps/project-name.js

@@ -0,0 +1,59 @@
+import { basename } from "node:path";
+import { text } from "@clack/prompts";
+import { guardCancel } from "../runner.js";
+export const projectNameStep = {
+    id: "project-name",
+    label: "Project name",
+    isConfigured(ctx) {
+        if (ctx.reset)
+            return false;
+        const key = ctx.currentProjectKey ?? ctx.results.projectKey;
+        if (!key)
+            return false;
+        const edited = ctx.results.projectEdits?.[key]?.name;
+        if (typeof edited === "string" && edited.trim() !== "")
+            return true;
+        const existing = ctx.existingConfig?.projects?.[key]?.name;
+        return typeof existing === "string" && existing.trim() !== "";
+    },
+    shouldSkip(ctx) {
+        const oneProject = (ctx.targetProjectKeys?.length ?? 1) <= 1;
+        return (oneProject &&
+            typeof ctx.prefill.name === "string" &&
+            ctx.prefill.name.trim() !== "");
+    },
+    run: async (ctx) => {
+        const key = ctx.currentProjectKey ?? ctx.results.projectKey ?? "prj1";
+        if (!ctx.results.projectEdits)
+            ctx.results.projectEdits = {};
+        ctx.results.projectEdits[key] ??= {};
+        // Pre-fill: apply silently (single-project only)
+        if ((ctx.targetProjectKeys?.length ?? 1) <= 1 && ctx.prefill.name) {
+            const pre = ctx.prefill.name.trim();
+            if (pre) {
+                ctx.results.projectEdits[key].name = pre;
+                ctx.results.projectName = pre;
+                return;
+            }
+        }
+        const cwd = ctx.results.projectEdits?.[key]?.cwd ??
+            ctx.existingConfig?.projects?.[key]?.cwd ??
+            ".";
+        const defaultName = cwd === "." || cwd === "./"
+            ? basename(ctx.cwd)
+            : basename(String(cwd)
+                .replace(/\/+$/g, "")
+                .replace(/^\.\/+/, ""));
+        const answer = await text({
+            message: `Project name (default: ${defaultName}):`,
+            placeholder: defaultName,
+        });
+        guardCancel(answer);
+        const name = typeof answer === "string" ? answer.trim() : "";
+        ctx.results.projectEdits[key].name = name === "" ? defaultName : name;
+        if (key === ctx.results.projectKey) {
+            ctx.results.projectName = ctx.results.projectEdits[key].name;
+        }
+    },
+};
+//# sourceMappingURL=project-name.js.map

package/dist/wizard/steps/project-name.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-name.js","sourceRoot":"","sources":["../../../src/wizard/steps/project-name.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AACtC,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAG3C,MAAM,CAAC,MAAM,eAAe,GAAe;IACzC,EAAE,EAAE,cAAc;IAClB,KAAK,EAAE,cAAc;IAErB,YAAY,CAAC,GAAkB;QAC7B,IAAI,GAAG,CAAC,KAAK;YAAE,OAAO,KAAK,CAAC;QAC5B,MAAM,GAAG,GAAG,GAAG,CAAC,iBAAiB,IAAI,GAAG,CAAC,OAAO,CAAC,UAAU,CAAC;QAC5D,IAAI,CAAC,GAAG;YAAE,OAAO,KAAK,CAAC;QACvB,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC;QACrD,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,OAAO,IAAI,CAAC;QACpE,MAAM,QAAQ,GAAG,GAAG,CAAC,cAAc,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC;QAC3D,OAAO,OAAO,QAAQ,KAAK,QAAQ,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;IAChE,CAAC;IAED,UAAU,CAAC,GAAkB;QAC3B,MAAM,UAAU,GAAG,CAAC,GAAG,CAAC,iBAAiB,EAAE,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC;QAC7D,OAAO,CACL,UAAU;YACV,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,KAAK,QAAQ;YACpC,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,CAC/B,CAAC;IACJ,CAAC;IAED,GAAG,EAAE,KAAK,EAAE,GAAkB,EAAE,EAAE;QAChC,MAAM,GAAG,GAAG,GAAG,CAAC,iBAAiB,IAAI,GAAG,CAAC,OAAO,CAAC,UAAU,IAAI,MAAM,CAAC;QACtE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY;YAAE,GAAG,CAAC,OAAO,CAAC,YAAY,GAAG,EAAE,CAAC;QAC7D,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;QAErC,iDAAiD;QACjD,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;YAClE,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YACpC,IAAI,GAAG,EAAE,CAAC;gBACR,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC;gBACzC,GAAG,CAAC,OAAO,CAAC,WAAW,GAAG,GAAG,CAAC;gBAC9B,OAAO;YACT,CAAC;QACH,CAAC;QAED,MAAM,GAAG,GACP,GAAG,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG;YACpC,GAAG,CAAC,cAAc,EAAE,QAAQ,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG;YACxC,GAAG,CAAC;QACN,MAAM,WAAW,GACf,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,IAAI;YACzB,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC;YACnB,CAAC,CAAC,QAAQ,CACN,MAAM,CAAC,GAAG,CAAC;iBACR,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;iBACpB,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CACzB,CAAC;QAER,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC;YACxB,OAAO,EAAE,0BAA0B,WAAW,IAAI;YAClD,WAAW,EAAE,WAAW;SACzB,CAAC,CAAC;QACH,WAAW,CAAC,MAAM,CAAC,CAAC;QAEpB,MAAM,IAAI,GAAG,OAAO,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,GAAG,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC;QACtE,IAAI,GAAG,KAAK,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC;YACnC,GAAG,CAAC,OAAO,CAAC,WAAW,GAAG,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC;QAC/D,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/wizard/steps/session.d.ts

@@ -0,0 +1,3 @@
+import type { WizardStep } from "../types.js";
+export declare const sessionStep: WizardStep;
+//# sourceMappingURL=session.d.ts.map

package/dist/wizard/steps/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/wizard/steps/session.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAA8B,UAAU,EAAE,MAAM,aAAa,CAAC;AAU1E,eAAO,MAAM,WAAW,EAAE,UAsEzB,CAAC"}

package/dist/wizard/steps/session.js

@@ -0,0 +1,81 @@
+import { select } from "@clack/prompts";
+import { guardCancel } from "../runner.js";
+function parseSessionMode(raw) {
+    if (raw === "true")
+        return true;
+    if (raw === "false")
+        return false;
+    if (raw === "shared")
+        return "shared";
+    if (raw === "user")
+        return "user";
+    return null;
+}
+export const sessionStep = {
+    id: "session",
+    label: "Session behavior",
+    isConfigured(ctx) {
+        // Session does not block boot: default behavior is used when unset.
+        // Only prompt when explicitly resetting.
+        if (!ctx.reset)
+            return true;
+        const globalSession = ctx.existingConfig?.globals?.engine?.session;
+        const projects = ctx.existingConfig?.projects ?? {};
+        const projectSession = Object.values(projects).some((p) => p.engine?.session !== undefined);
+        return globalSession !== undefined || projectSession;
+    },
+    shouldSkip(ctx) {
+        if (!ctx.prefill.session)
+            return false;
+        return parseSessionMode(ctx.prefill.session) !== null;
+    },
+    run: async (ctx) => {
+        // Pre-fill: apply silently
+        if (ctx.prefill.session) {
+            const mode = parseSessionMode(ctx.prefill.session);
+            if (mode !== null) {
+                ctx.results.session = mode;
+                return;
+            }
+        }
+        const engine = ctx.results.engine ?? "";
+        // Single clear session picker with only supported options
+        const options = [
+            {
+                value: "default",
+                label: "default — engine default session mechanism",
+            },
+            {
+                value: "disabled",
+                label: "disabled — each message is anonymous (no resume/continue)",
+            },
+        ];
+        if (engine === "claude") {
+            options.push({
+                value: "shared",
+                label: "shared — all users share the same session (--continue)",
+            });
+        }
+        if (engine === "codex" || engine === "cursor") {
+            options.push({
+                value: "user",
+                label: "user — each user has their own session (engine-supported)",
+            });
+        }
+        const picked = await select({
+            message: "How should the session work?",
+            options,
+        });
+        guardCancel(picked);
+        const v = picked;
+        if (v === "disabled")
+            ctx.results.session = false;
+        else if (v === "shared")
+            ctx.results.session = "shared";
+        else if (v === "user")
+            ctx.results.session = "user";
+        else
+            ctx.results.session = true;
+    },
+};
+//# sourceMappingURL=session.js.map

package/dist/wizard/steps/session.js.map

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

package/dist/wizard/steps/user-id.d.ts

@@ -0,0 +1,3 @@
+import type { WizardStep } from "../types.js";
+export declare const userIdStep: WizardStep;
+//# sourceMappingURL=user-id.d.ts.map

package/dist/wizard/steps/user-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-id.d.ts","sourceRoot":"","sources":["../../../src/wizard/steps/user-id.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAiB,UAAU,EAAE,MAAM,aAAa,CAAC;AAgG7D,eAAO,MAAM,UAAU,EAAE,UAoExB,CAAC"}

package/dist/wizard/steps/user-id.js

@@ -0,0 +1,155 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+import { confirm, text } from "@clack/prompts";
+import { parse as parseEnv } from "dotenv";
+import { resolveCustomEnvPaths } from "../../config.js";
+import { guardCancel } from "../runner.js";
+const TELEGRAM_USER_ID_MAX = 0xfffffffff;
+const HELP_URL = "https://github.com/marcopeg/hal/blob/main/docs/telegram/README.md";
+/** Placeholder pattern — e.g. "${SOME_VAR}" */
+const PLACEHOLDER_RE = /^\$\{[^}]+\}$/;
+function isPlaceholder(value) {
+    return typeof value === "string" && PLACEHOLDER_RE.test(value.trim());
+}
+function placeholderVar(value) {
+    if (!isPlaceholder(value))
+        return null;
+    const s = value.trim();
+    return s.slice(2, -1).trim() || null;
+}
+function parseUserId(raw) {
+    const str = raw.trim();
+    const num = Number(str);
+    if (!Number.isFinite(num) || !Number.isInteger(num))
+        return null;
+    if (num < 1 || num > TELEGRAM_USER_ID_MAX)
+        return null;
+    return num;
+}
+function loadEnvFromConfigDir(configDir) {
+    const out = {};
+    for (const file of [join(configDir, ".env"), join(configDir, ".env.local")]) {
+        if (!existsSync(file))
+            continue;
+        try {
+            const parsed = parseEnv(readFileSync(file, "utf-8"));
+            Object.assign(out, parsed);
+        }
+        catch {
+            // ignore
+        }
+    }
+    return out;
+}
+function loadEnvForConfig(configDir, parsed) {
+    if (parsed && typeof parsed.env === "string" && parsed.env.trim() !== "") {
+        const { mainPath, localPath } = resolveCustomEnvPaths(configDir, parsed.env);
+        const out = {};
+        for (const file of [mainPath, localPath]) {
+            if (!existsSync(file))
+                continue;
+            try {
+                const parsedEnv = parseEnv(readFileSync(file, "utf-8"));
+                Object.assign(out, parsedEnv);
+            }
+            catch {
+                // ignore
+            }
+        }
+        return out;
+    }
+    return loadEnvFromConfigDir(configDir);
+}
+function hasResolvableId(ids, env) {
+    if (!ids || ids.length === 0)
+        return false;
+    return ids.some((id) => {
+        if (typeof id === "number")
+            return id > 0;
+        if (typeof id !== "string")
+            return false;
+        const trimmed = id.trim();
+        // Raw numeric string
+        if (!PLACEHOLDER_RE.test(trimmed))
+            return parseUserId(trimmed) !== null;
+        // Placeholder: resolve via process env or .env/.env.local (or custom env path)
+        const varName = placeholderVar(trimmed);
+        if (!varName)
+            return false;
+        const raw = (process.env[varName] ?? env[varName]) || "";
+        return parseUserId(raw) !== null;
+    });
+}
+function hasRealId(ids) {
+    if (!ids || ids.length === 0)
+        return false;
+    return ids.some((id) => {
+        if (typeof id === "number")
+            return id > 0;
+        if (typeof id === "string")
+            return parseUserId(id) !== null;
+        return false;
+    });
+}
+export const userIdStep = {
+    id: "user-id",
+    label: "Your Telegram user ID",
+    isConfigured(ctx) {
+        const env = loadEnvForConfig(ctx.cwd, ctx.existingConfig);
+        const globalIds = ctx.existingConfig?.globals?.access?.allowedUserIds;
+        const projects = ctx.existingConfig?.projects ?? {};
+        const projectIds = Object.values(projects).flatMap((p) => p.access?.allowedUserIds ?? []);
+        return (hasResolvableId(globalIds, env) ||
+            hasResolvableId(projectIds, env) ||
+            // Back-compat: treat raw numeric strings/numbers as configured too
+            hasRealId(globalIds) ||
+            hasRealId(projectIds));
+    },
+    shouldSkip(ctx) {
+        if (!ctx.prefill.userId)
+            return false;
+        return parseUserId(ctx.prefill.userId) !== null;
+    },
+    run: async (ctx) => {
+        if (ctx.prefill.userId) {
+            const n = parseUserId(ctx.prefill.userId);
+            if (n !== null) {
+                ctx.results.userId = n;
+                return;
+            }
+        }
+        const needHelp = await confirm({
+            message: "Do you need help finding your Telegram user ID? (opens docs)",
+            initialValue: false,
+        });
+        guardCancel(needHelp);
+        if (needHelp) {
+            try {
+                const cmd = process.platform === "darwin"
+                    ? "open"
+                    : process.platform === "win32"
+                        ? "start"
+                        : "xdg-open";
+                const { spawn } = await import("node:child_process");
+                spawn(cmd, [HELP_URL], { stdio: "ignore", detached: true }).unref();
+            }
+            catch { }
+            console.log(`\n  Docs: ${HELP_URL}\n`);
+        }
+        const answer = await text({
+            message: "Enter your Telegram user ID (numeric):",
+            placeholder: "123456789",
+            validate(value) {
+                if (!value || value.trim() === "")
+                    return "User ID is required.";
+                const n = parseUserId(value);
+                if (n === null)
+                    return `Invalid user ID. Must be a positive integer up to ${TELEGRAM_USER_ID_MAX}.`;
+                return undefined;
+            },
+        });
+        guardCancel(answer);
+        ctx.results.userId = parseUserId(answer.trim());
+    },
+};
+//# sourceMappingURL=user-id.js.map

package/dist/wizard/steps/user-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-id.js","sourceRoot":"","sources":["../../../src/wizard/steps/user-id.ts"],"names":[],"mappings":"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"}

package/dist/wizard/types.d.ts

@@ -0,0 +1,108 @@
+import type { ConfigFormat, SessionMode } from "../config.js";
+export type { SessionMode };
+/**
+ * Loosely-typed raw config object (pre-Zod), read directly from the config
+ * file without env-var substitution. Only covers fields the wizard cares about.
+ */
+export interface PartialConfig {
+    providers?: unknown;
+    env?: string;
+    globals?: {
+        access?: {
+            allowedUserIds?: unknown[];
+        };
+        engine?: {
+            name?: string;
+            model?: string;
+            session?: unknown;
+        };
+    };
+    projects?: Record<string, {
+        active?: boolean;
+        name?: string;
+        cwd?: string;
+        telegram?: {
+            botToken?: string;
+        };
+        access?: {
+            allowedUserIds?: unknown[];
+        };
+        engine?: {
+            name?: string;
+            model?: string;
+            session?: unknown;
+        };
+    }>;
+}
+export type ProjectEdits = Record<string, {
+    cwd?: string;
+    botToken?: string;
+    name?: string;
+}>;
+export interface PrefillFlags {
+    /** Project display name (wizard step 1). */
+    name?: string;
+    /** Project cwd (wizard step 2). */
+    cwd?: string;
+    engine?: string;
+    model?: string;
+    /** Telegram bot token to use for the project. */
+    apiKey?: string;
+    /** Back-compat alias for apiKey. */
+    botKey?: string;
+    userId?: string;
+    session?: string;
+}
+export interface WizardContext {
+    /** Config directory (where hal.config.* lives / will be written). */
+    cwd: string;
+    /** Parsed existing config, or null when creating from scratch. */
+    existingConfig: PartialConfig | null;
+    /** Absolute path to the existing config file, or null. */
+    existingConfigPath: string | null;
+    /** Format of the existing config file (drives write-back format). null = fresh → default YAML. */
+    existingConfigFormat: ConfigFormat | null;
+    /** CLI pre-fill flags. */
+    prefill: PrefillFlags;
+    /** When true, skip isConfigured checks and re-prompt all steps. */
+    reset: boolean;
+    /** Active projects the wizard should validate/fill (existing config only). */
+    targetProjectKeys?: string[];
+    /** Project currently being filled (project-scoped steps). */
+    currentProjectKey?: string | null;
+    /** Background engine discovery; started at wizard boot. */
+    availableEnginesPromise?: Promise<string[]>;
+    /** Accumulates outputs from each step. */
+    results: {
+        projectKey?: string;
+        projectName?: string;
+        cwd?: string;
+        /** Engines enabled in config providers (for /engine switching). */
+        enabledEngines?: string[];
+        botToken?: string;
+        /** Multi-project edits (project-scoped). */
+        projectEdits?: ProjectEdits;
+        userId?: number;
+        additionalUserIds?: number[];
+        /** Default engine (stored in globals.engine.*). */
+        engine?: string;
+        /** Default model for globals.engine.*. */
+        model?: string;
+        session?: SessionMode;
+        /** Whether to store secrets inline in config or via .env placeholders. */
+        secretsMode?: "env" | "inline";
+        /** set by confirm-and-write */
+        startBot?: boolean;
+    };
+}
+export interface WizardStep {
+    id: string;
+    label: string;
+    /** True when this step's value is already present in the config and --reset is false. */
+    isConfigured(ctx: WizardContext): boolean;
+    /** Additional skip logic beyond isConfigured (e.g. prefill provided). */
+    shouldSkip?(ctx: WizardContext): boolean;
+    /** Run the step, mutating ctx.results in place. */
+    run(ctx: WizardContext): Promise<void>;
+}
+//# sourceMappingURL=types.d.ts.map

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

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

package/dist/wizard/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/wizard/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/wizard/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@marcopeg/hal",
-  "version": "1.0.32",
+  "version": "1.0.34",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
@@ -30,6 +30,7 @@
     "url": "git+https://github.com/marcopeg/hal.git"
   },
   "dependencies": {
+    "@clack/prompts": "^1.1.0",
     "chokidar": "^5.0.0",
     "dotenv": "^17.2.3",
     "grammy": "^1.39.2",
@@ -52,7 +53,11 @@
     "node": ">=18"
   },
   "scripts": {
-    "start": "tsx watch src/cli.ts start --cwd examples",
+    "start": "tsx src/cli.ts start --config-dir examples",
+    "dev": "tsx watch src/cli.ts start --config-dir examples",
+    "start:test": "tsx src/cli.ts start --config-dir manual-tests",
+    "dev:test": "tsx watch src/cli.ts start --config-dir manual-tests",
+    "wiz:test": "tsx src/cli.ts wiz --config-dir manual-tests",
     "build": "tsc && cp src/init-template.yaml dist/ && chmod +x dist/cli.js",
     "typecheck": "tsc --noEmit",
     "lint": "biome check src",