@marcopeg/hal 1.0.11 → 1.0.12

package/dist/engine/adapters/copilot.js

@@ -0,0 +1,109 @@
+import { execSync, spawn } from "node:child_process";
+import { join } from "node:path";
+import { buildContextualPrompt } from "../prompt.js";
+const DEFAULT_COMMAND = "copilot";
+export function createCopilotAdapter(command, model) {
+    const cmd = command || DEFAULT_COMMAND;
+    return {
+        name: "GitHub Copilot",
+        command: cmd,
+        check() {
+            try {
+                execSync(`${cmd} --version`, { stdio: "pipe" });
+            }
+            catch {
+                throw new Error(`Copilot CLI command "${cmd}" not found or not executable. ` +
+                    `Please ensure GitHub Copilot CLI is installed and the command is in your PATH.`);
+            }
+        },
+        async execute(options, ctx) {
+            const { sessionId, onProgress } = options;
+            const { config, logger } = ctx;
+            const fullPrompt = await buildContextualPrompt(options, ctx);
+            // Copilot CLI flags (confirmed via `copilot --help`):
+            //   -p <text>       Non-interactive prompt (exits after completion)
+            //   -s / --silent   Clean output for scripting (no stats banner)
+            //   --allow-all     Enable all permissions (tools + paths + urls)
+            //   --model <model> Override the AI model
+            //   --resume [id]   Resume a previous session
+            const args = ["-p", fullPrompt, "--allow-all"];
+            // Set model if specified
+            if (model) {
+                args.push("--model", model);
+            }
+            // Resume session if available
+            if (sessionId) {
+                args.push("--resume", sessionId);
+            }
+            const cwd = config.cwd;
+            logger.info({ command: cmd, cwd }, "Executing Copilot CLI");
+            return new Promise((resolve) => {
+                const proc = spawn(cmd, args, {
+                    cwd,
+                    env: process.env,
+                    stdio: ["ignore", "pipe", "pipe"],
+                });
+                let stdout = "";
+                let stderrOutput = "";
+                proc.stdout.on("data", (data) => {
+                    const chunk = data.toString();
+                    stdout += chunk;
+                    // Copilot in silent mode outputs plain text.
+                    // Send incremental progress if a callback is provided.
+                    if (onProgress && chunk.trim()) {
+                        onProgress("Copilot is responding...");
+                    }
+                });
+                proc.stderr.on("data", (data) => {
+                    const chunk = data.toString().trim();
+                    if (chunk) {
+                        stderrOutput += `${chunk}\n`;
+                        logger.info({ stderr: chunk }, "Copilot stderr");
+                    }
+                });
+                proc.on("close", (code) => {
+                    logger.info({ code }, "Copilot process closed");
+                    if (code === 0) {
+                        resolve({
+                            success: true,
+                            output: stdout.trim() || "No response received",
+                        });
+                    }
+                    else {
+                        const errorMsg = stderrOutput.trim() || `Copilot exited with code ${code}`;
+                        logger.error({ code, stderr: stderrOutput }, "Copilot process failed");
+                        resolve({
+                            success: false,
+                            output: stdout.trim(),
+                            error: errorMsg,
+                        });
+                    }
+                });
+                proc.on("error", (err) => {
+                    logger.error({ error: err.message }, "Copilot process error");
+                    resolve({
+                        success: false,
+                        output: "",
+                        error: `Failed to start ${cmd}: ${err.message}`,
+                    });
+                });
+            });
+        },
+        parse(result) {
+            if (!result.success) {
+                return { text: result.error || "An unknown error occurred" };
+            }
+            return {
+                text: result.output || "No response received",
+            };
+        },
+        skillsDir(projectCwd) {
+            // All engines share .claude/skills/ for now (portable; revisit later)
+            return join(projectCwd, ".claude", "skills");
+        },
+        instructionsFile() {
+            return "AGENTS.md";
+        },
+    };
+}
+//# sourceMappingURL=copilot.js.map

package/dist/engine/adapters/copilot.js.map

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

package/dist/engine/adapters/opencode.d.ts

@@ -0,0 +1,7 @@
+import type { EngineAdapter } from "../types.js";
+/**
+ * Stub adapter for OpenCode CLI.
+ * TODO: Confirm exact CLI flags, streaming support, and output format.
+ */
+export declare function createOpencodeAdapter(command?: string, model?: string): EngineAdapter;
+//# sourceMappingURL=opencode.d.ts.map

package/dist/engine/adapters/opencode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opencode.d.ts","sourceRoot":"","sources":["../../../src/engine/adapters/opencode.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,aAAa,EAId,MAAM,aAAa,CAAC;AAIrB;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,CAAC,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM,GACb,aAAa,CAuGf"}

package/dist/engine/adapters/opencode.js

@@ -0,0 +1,94 @@
+import { execSync, spawn } from "node:child_process";
+import { join } from "node:path";
+import { buildContextualPrompt } from "../prompt.js";
+const DEFAULT_COMMAND = "opencode";
+/**
+ * Stub adapter for OpenCode CLI.
+ * TODO: Confirm exact CLI flags, streaming support, and output format.
+ */
+export function createOpencodeAdapter(command, model) {
+    const cmd = command || DEFAULT_COMMAND;
+    return {
+        name: "OpenCode",
+        command: cmd,
+        check() {
+            try {
+                execSync(`${cmd} --version`, { stdio: "pipe" });
+            }
+            catch {
+                throw new Error(`OpenCode CLI command "${cmd}" not found or not executable. ` +
+                    `Please ensure OpenCode CLI is installed and the command is in your PATH.`);
+            }
+        },
+        async execute(options, ctx) {
+            const { config, logger } = ctx;
+            const fullPrompt = await buildContextualPrompt(options, ctx);
+            // TODO: Confirm exact opencode CLI flags — using best-guess values.
+            const args = ["-p", fullPrompt];
+            // Set model if specified
+            if (model) {
+                args.push("--model", model);
+            }
+            const cwd = config.cwd;
+            logger.info({ command: cmd, cwd }, "Executing OpenCode CLI");
+            logger.warn("OpenCode adapter is a stub — CLI flags may need adjustment");
+            return new Promise((resolve) => {
+                const proc = spawn(cmd, args, {
+                    cwd,
+                    env: process.env,
+                    stdio: ["ignore", "pipe", "pipe"],
+                });
+                let stdout = "";
+                let stderrOutput = "";
+                proc.stdout.on("data", (data) => {
+                    stdout += data.toString();
+                });
+                proc.stderr.on("data", (data) => {
+                    const chunk = data.toString().trim();
+                    if (chunk) {
+                        stderrOutput += `${chunk}\n`;
+                        logger.debug({ stderr: chunk }, "OpenCode stderr");
+                    }
+                });
+                proc.on("close", (code) => {
+                    logger.debug({ code }, "OpenCode process closed");
+                    if (code === 0) {
+                        resolve({
+                            success: true,
+                            output: stdout.trim() || "No response received",
+                        });
+                    }
+                    else {
+                        resolve({
+                            success: false,
+                            output: "",
+                            error: stderrOutput.trim() || `OpenCode exited with code ${code}`,
+                        });
+                    }
+                });
+                proc.on("error", (err) => {
+                    logger.error({ error: err.message }, "OpenCode process error");
+                    resolve({
+                        success: false,
+                        output: "",
+                        error: `Failed to start ${cmd}: ${err.message}`,
+                    });
+                });
+            });
+        },
+        parse(result) {
+            if (!result.success) {
+                return { text: result.error || "An unknown error occurred" };
+            }
+            return { text: result.output || "No response received" };
+        },
+        skillsDir(projectCwd) {
+            // All engines share .claude/skills/ for now
+            return join(projectCwd, ".claude", "skills");
+        },
+        instructionsFile() {
+            return "AGENTS.md";
+        },
+    };
+}
+//# sourceMappingURL=opencode.js.map

package/dist/engine/adapters/opencode.js.map

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

package/dist/engine/index.d.ts

@@ -0,0 +1,4 @@
+export { getEngine } from "./registry.js";
+export type { EngineAdapter, EngineExecuteOptions, EngineName, EngineResult, ParsedResponse, } from "./types.js";
+export { ENGINE_NAMES } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/engine/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/engine/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,YAAY,EACV,aAAa,EACb,oBAAoB,EACpB,UAAU,EACV,YAAY,EACZ,cAAc,GACf,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/engine/index.js

@@ -0,0 +1,3 @@
+export { getEngine } from "./registry.js";
+export { ENGINE_NAMES } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/engine/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/engine/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAQ1C,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC"}

package/dist/engine/prompt.d.ts

@@ -0,0 +1,9 @@
+import type { ProjectContext } from "../types.js";
+import type { EngineExecuteOptions } from "./types.js";
+/**
+ * Build a fully-resolved prompt from engine execute options.
+ * Handles context injection and downloads-path system message.
+ * Shared across all engine adapters.
+ */
+export declare function buildContextualPrompt(options: EngineExecuteOptions, ctx: ProjectContext): Promise<string>;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/engine/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../src/engine/prompt.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD;;;;GAIG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,oBAAoB,EAC7B,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,MAAM,CAAC,CAwBjB"}

package/dist/engine/prompt.js

@@ -0,0 +1,29 @@
+import { formatContextPrompt, resolveContext } from "../context/resolver.js";
+/**
+ * Build a fully-resolved prompt from engine execute options.
+ * Handles context injection and downloads-path system message.
+ * Shared across all engine adapters.
+ */
+export async function buildContextualPrompt(options, ctx) {
+    const { prompt, gramCtx, downloadsPath } = options;
+    const { config, logger, bootContext } = ctx;
+    let contextualPrompt = prompt;
+    if (gramCtx) {
+        const resolvedCtx = await resolveContext({
+            gramCtx,
+            configContext: config.context,
+            bootContext,
+            configDir: config.configDir,
+            projectCwd: config.cwd,
+            projectName: config.name,
+            projectSlug: config.slug,
+            logger,
+        });
+        contextualPrompt = formatContextPrompt(resolvedCtx, prompt);
+    }
+    if (downloadsPath) {
+        return `${contextualPrompt}\n\n[System: To send files to the user, write them to: ${downloadsPath}]`;
+    }
+    return contextualPrompt;
+}
+//# sourceMappingURL=prompt.js.map

package/dist/engine/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../src/engine/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAI7E;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAA6B,EAC7B,GAAmB;IAEnB,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,GAAG,OAAO,CAAC;IACnD,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,GAAG,CAAC;IAE5C,IAAI,gBAAgB,GAAG,MAAM,CAAC;IAC9B,IAAI,OAAO,EAAE,CAAC;QACZ,MAAM,WAAW,GAAG,MAAM,cAAc,CAAC;YACvC,OAAO;YACP,aAAa,EAAE,MAAM,CAAC,OAAO;YAC7B,WAAW;YACX,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,UAAU,EAAE,MAAM,CAAC,GAAG;YACtB,WAAW,EAAE,MAAM,CAAC,IAAI;YACxB,WAAW,EAAE,MAAM,CAAC,IAAI;YACxB,MAAM;SACP,CAAC,CAAC;QACH,gBAAgB,GAAG,mBAAmB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC9D,CAAC;IAED,IAAI,aAAa,EAAE,CAAC;QAClB,OAAO,GAAG,gBAAgB,0DAA0D,aAAa,GAAG,CAAC;IACvG,CAAC;IAED,OAAO,gBAAgB,CAAC;AAC1B,CAAC"}

package/dist/engine/registry.d.ts

@@ -0,0 +1,9 @@
+import type { EngineAdapter, EngineName } from "./types.js";
+/**
+ * Create an engine adapter by name.
+ * @param name - Engine identifier
+ * @param command - Optional custom CLI command override
+ * @param model - Optional model override (omit to use engine default)
+ */
+export declare function getEngine(name: EngineName, command?: string, model?: string): EngineAdapter;
+//# sourceMappingURL=registry.d.ts.map

package/dist/engine/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/engine/registry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAW5D;;;;;GAKG;AACH,wBAAgB,SAAS,CACvB,IAAI,EAAE,UAAU,EAChB,OAAO,CAAC,EAAE,MAAM,EAChB,KAAK,CAAC,EAAE,MAAM,GACb,aAAa,CAQf"}

package/dist/engine/registry.js

@@ -0,0 +1,24 @@
+import { createClaudeAdapter } from "./adapters/claude.js";
+import { createCodexAdapter } from "./adapters/codex.js";
+import { createCopilotAdapter } from "./adapters/copilot.js";
+import { createOpencodeAdapter } from "./adapters/opencode.js";
+const factories = {
+    claude: createClaudeAdapter,
+    copilot: createCopilotAdapter,
+    codex: createCodexAdapter,
+    opencode: createOpencodeAdapter,
+};
+/**
+ * Create an engine adapter by name.
+ * @param name - Engine identifier
+ * @param command - Optional custom CLI command override
+ * @param model - Optional model override (omit to use engine default)
+ */
+export function getEngine(name, command, model) {
+    const factory = factories[name];
+    if (!factory) {
+        throw new Error(`Unknown engine "${name}". Supported: ${Object.keys(factories).join(", ")}`);
+    }
+    return factory(command, model);
+}
+//# sourceMappingURL=registry.js.map

package/dist/engine/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../src/engine/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,oBAAoB,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAK/D,MAAM,SAAS,GAAuC;IACpD,MAAM,EAAE,mBAAmB;IAC3B,OAAO,EAAE,oBAAoB;IAC7B,KAAK,EAAE,kBAAkB;IACzB,QAAQ,EAAE,qBAAqB;CAChC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CACvB,IAAgB,EAChB,OAAgB,EAChB,KAAc;IAEd,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CACb,mBAAmB,IAAI,iBAAiB,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAC5E,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;AACjC,CAAC"}

package/dist/engine/types.d.ts

@@ -0,0 +1,42 @@
+import type { Context as GrammyContext } from "grammy";
+import type { ProjectContext } from "../types.js";
+export type EngineName = "claude" | "copilot" | "codex" | "opencode";
+export declare const ENGINE_NAMES: readonly EngineName[];
+export interface EngineExecuteOptions {
+    prompt: string;
+    userDir: string;
+    gramCtx?: GrammyContext;
+    downloadsPath?: string;
+    sessionId?: string | null;
+    onProgress?: (message: string) => void;
+}
+export interface EngineResult {
+    success: boolean;
+    output: string;
+    sessionId?: string;
+    error?: string;
+}
+export interface ParsedResponse {
+    text: string;
+    sessionId?: string;
+    costUsd?: number;
+    inputTokens?: number;
+    outputTokens?: number;
+}
+export interface EngineAdapter {
+    /** Human-readable engine name for logs/errors */
+    readonly name: string;
+    /** CLI command to invoke (e.g. "claude", "copilot") */
+    readonly command: string;
+    /** Verify the CLI is installed and available; throw on failure */
+    check(): void;
+    /** Execute a prompt and return a normalised result */
+    execute(options: EngineExecuteOptions, ctx: ProjectContext): Promise<EngineResult>;
+    /** Parse raw result into user-facing response */
+    parse(result: EngineResult): ParsedResponse;
+    /** Return the skills directory path for a project */
+    skillsDir(projectCwd: string): string;
+    /** Return the instructions filename for init scaffolding */
+    instructionsFile(): string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/engine/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAIlD,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,UAAU,CAAC;AAErE,eAAO,MAAM,YAAY,EAAE,SAAS,UAAU,EAKpC,CAAC;AAIX,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACxC;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAID,MAAM,WAAW,aAAa;IAC5B,iDAAiD;IACjD,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,uDAAuD;IACvD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,kEAAkE;IAClE,KAAK,IAAI,IAAI,CAAC;IACd,sDAAsD;IACtD,OAAO,CACL,OAAO,EAAE,oBAAoB,EAC7B,GAAG,EAAE,cAAc,GAClB,OAAO,CAAC,YAAY,CAAC,CAAC;IACzB,iDAAiD;IACjD,KAAK,CAAC,MAAM,EAAE,YAAY,GAAG,cAAc,CAAC;IAC5C,qDAAqD;IACrD,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;IACtC,4DAA4D;IAC5D,gBAAgB,IAAI,MAAM,CAAC;CAC5B"}

package/dist/engine/types.js

@@ -0,0 +1,7 @@
+export const ENGINE_NAMES = [
+    "claude",
+    "copilot",
+    "codex",
+    "opencode",
+];
+//# sourceMappingURL=types.js.map

package/dist/engine/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/engine/types.ts"],"names":[],"mappings":"AAOA,MAAM,CAAC,MAAM,YAAY,GAA0B;IACjD,QAAQ;IACR,SAAS;IACT,OAAO;IACP,UAAU;CACF,CAAC"}

package/dist/types.d.ts

@@ -1,9 +1,10 @@
 import type pino from "pino";
 import type { ResolvedProjectConfig } from "./config.js";
 import type { BootContext } from "./context/resolver.js";
+import type { EngineAdapter } from "./engine/types.js";
 /**
  * Engine-agnostic interface for making one-shot AI calls from command handlers.
- * The underlying provider (Claude Code, Codex, etc.) is an implementation detail.
+ * The underlying provider (Claude Code, Copilot, etc.) is an implementation detail.
  */
 export interface Agent {
     call(prompt: string, options?: {
@@ -18,5 +19,6 @@ export interface ProjectContext {
     config: ResolvedProjectConfig;
     logger: pino.Logger;
     bootContext: BootContext;
+    engine: EngineAdapter;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEzD;;;GAGG;AACH,MAAM,WAAW,KAAK;IACpB,IAAI,CACF,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,GACnD,OAAO,CAAC,MAAM,CAAC,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,qBAAqB,CAAC;IAC9B,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;IACpB,WAAW,EAAE,WAAW,CAAC;CAC1B"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AACzD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAEvD;;;GAGG;AACH,MAAM,WAAW,KAAK;IACpB,IAAI,CACF,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;KAAE,GACnD,OAAO,CAAC,MAAM,CAAC,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,qBAAqB,CAAC;IAC9B,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;IACpB,WAAW,EAAE,WAAW,CAAC;IACzB,MAAM,EAAE,aAAa,CAAC;CACvB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@marcopeg/hal",
-  "version": "1.0.11",
+  "version": "1.0.12",
   "type": "module",
   "main": "dist/index.js",
   "bin": {