@rkat/sdk 0.3.4

package/dist/client.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Meerkat client — spawns rkat-rpc subprocess and communicates via JSON-RPC.
+ */
+import type { WireRunResult, CapabilitiesResponse } from "./generated/types.js";
+/** Supplementary discovery metadata for a comms peer. */
+export interface PeerMeta {
+    description?: string;
+    labels?: Record<string, string>;
+}
+export declare class MeerkatClient {
+    private process;
+    private requestId;
+    private capabilities;
+    private rkatPath;
+    private pendingRequests;
+    constructor(rkatPath?: string);
+    private static commandPath;
+    private static resolveCandidatePath;
+    private static platformTarget;
+    private static runCommand;
+    private static extractZip;
+    private static ensureDownloadedBinary;
+    private static resolveBinaryPath;
+    connect(options?: {
+        realmId?: string;
+        instanceId?: string;
+        realmBackend?: "jsonl" | "redb";
+        isolated?: boolean;
+        stateRoot?: string;
+        contextRoot?: string;
+        userConfigRoot?: string;
+    }): Promise<this>;
+    close(): Promise<void>;
+    createSession(params: {
+        prompt: string;
+        model?: string;
+        provider?: string;
+        system_prompt?: string;
+        max_tokens?: number;
+        output_schema?: Record<string, unknown>;
+        structured_output_retries?: number;
+        hooks_override?: Record<string, unknown>;
+        enable_builtins?: boolean;
+        enable_shell?: boolean;
+        enable_subagents?: boolean;
+        enable_memory?: boolean;
+        host_mode?: boolean;
+        comms_name?: string;
+        peer_meta?: PeerMeta;
+        provider_params?: Record<string, unknown>;
+        preload_skills?: string[];
+        skill_references?: string[];
+    }): Promise<WireRunResult>;
+    startTurn(sessionId: string, prompt: string, options?: {
+        skill_references?: string[];
+    }): Promise<WireRunResult>;
+    interrupt(sessionId: string): Promise<void>;
+    listSessions(): Promise<unknown[]>;
+    readSession(sessionId: string): Promise<Record<string, unknown>>;
+    archiveSession(sessionId: string): Promise<void>;
+    getCapabilities(): Promise<CapabilitiesResponse>;
+    hasCapability(capabilityId: string): boolean;
+    requireCapability(capabilityId: string): void;
+    getConfig(): Promise<Record<string, unknown>>;
+    setConfig(config: Record<string, unknown>): Promise<void>;
+    patchConfig(patch: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /**
+     * Send a canonical comms command to a session.
+     *
+     * @param sessionId - Target session ID
+     * @param command - Command fields (kind, to, body, intent, params, etc.)
+     * @returns Receipt info on success
+     */
+    send(sessionId: string, command: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /**
+     * Send a command and open a stream in one call.
+     *
+     * @param sessionId - Target session ID
+     * @param command - Command fields (kind, to, body, etc.)
+     * @returns Receipt and stream info
+     */
+    sendAndStream(sessionId: string, command: Record<string, unknown>): Promise<Record<string, unknown>>;
+    /**
+     * List peers visible to a session's comms runtime.
+     *
+     * @param sessionId - Target session ID
+     * @returns Object with `{ peers: [...] }`
+     */
+    peers(sessionId: string): Promise<{
+        peers: Array<Record<string, unknown>>;
+    }>;
+    /**
+     * Normalize a CapabilityStatus from the wire.
+     * Available is the string "Available", but other variants are
+     * externally-tagged objects like {"DisabledByPolicy": {"description": "..."}}.
+     * We normalize to the variant name string.
+     */
+    private static normalizeStatus;
+    private request;
+    private checkVersionCompatible;
+    private parseRunResult;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/client.js

@@ -0,0 +1,465 @@
+/**
+ * Meerkat client — spawns rkat-rpc subprocess and communicates via JSON-RPC.
+ */
+import { spawn } from "node:child_process";
+import { chmodSync, existsSync, mkdirSync, unlinkSync, writeFileSync, } from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { createInterface } from "node:readline";
+import { MeerkatError } from "./generated/errors.js";
+import { CONTRACT_VERSION } from "./generated/types.js";
+const MEERKAT_REPO = "lukacf/meerkat";
+const MEERKAT_RELEASE_BINARY = "rkat-rpc";
+const MEERKAT_BINARY_CACHE_ROOT = path.join(os.homedir(), ".cache", "meerkat", "bin", MEERKAT_RELEASE_BINARY);
+export class MeerkatClient {
+    process = null;
+    requestId = 0;
+    capabilities = null;
+    rkatPath;
+    pendingRequests = new Map();
+    constructor(rkatPath = "rkat-rpc") {
+        this.rkatPath = rkatPath;
+    }
+    static commandPath(command) {
+        if (path.isAbsolute(command)) {
+            return existsSync(command) ? command : null;
+        }
+        const pathEnv = process.env.PATH ?? "";
+        if (!pathEnv)
+            return null;
+        const exts = process.platform === "win32"
+            ? (process.env.PATHEXT ?? ".EXE;.CMD;.BAT;.COM")
+                .split(";")
+                .filter((ext) => ext.length > 0)
+            : [""];
+        for (const dir of pathEnv.split(path.delimiter)) {
+            if (!dir)
+                continue;
+            for (const ext of exts) {
+                const candidate = process.platform === "win32" &&
+                    ext &&
+                    !command.toLowerCase().endsWith(ext.toLowerCase())
+                    ? `${command}${ext}`
+                    : command;
+                const fullPath = path.join(dir, candidate);
+                if (existsSync(fullPath))
+                    return fullPath;
+            }
+        }
+        return null;
+    }
+    static resolveCandidatePath(commandOrPath) {
+        if (commandOrPath.includes(path.sep) || commandOrPath.includes("/")) {
+            const candidate = path.resolve(commandOrPath);
+            return existsSync(candidate) ? candidate : null;
+        }
+        return MeerkatClient.commandPath(commandOrPath);
+    }
+    static platformTarget() {
+        const architecture = os.arch();
+        if (process.platform === "darwin") {
+            if (architecture === "arm64") {
+                return {
+                    target: "aarch64-apple-darwin",
+                    archiveExt: "tar.gz",
+                    binaryName: "rkat-rpc",
+                };
+            }
+            throw new MeerkatError("UNSUPPORTED_PLATFORM", `Unsupported macOS architecture '${architecture}'. Only Apple Silicon (arm64) is supported.`);
+        }
+        if (process.platform === "linux") {
+            if (architecture === "x64") {
+                return {
+                    target: "x86_64-unknown-linux-gnu",
+                    archiveExt: "tar.gz",
+                    binaryName: "rkat-rpc",
+                };
+            }
+            if (architecture === "arm64") {
+                return {
+                    target: "aarch64-unknown-linux-gnu",
+                    archiveExt: "tar.gz",
+                    binaryName: "rkat-rpc",
+                };
+            }
+            throw new MeerkatError("UNSUPPORTED_PLATFORM", `Unsupported Linux architecture '${architecture}'.`);
+        }
+        if (process.platform === "win32") {
+            if (architecture === "x64") {
+                return {
+                    target: "x86_64-pc-windows-msvc",
+                    archiveExt: "zip",
+                    binaryName: "rkat-rpc.exe",
+                };
+            }
+            throw new MeerkatError("UNSUPPORTED_PLATFORM", `Unsupported Windows architecture '${architecture}'.`);
+        }
+        throw new MeerkatError("UNSUPPORTED_PLATFORM", `Unsupported platform '${process.platform}'.`);
+    }
+    static async runCommand(command, args) {
+        return new Promise((resolve, reject) => {
+            const proc = spawn(command, args, { stdio: ["ignore", "inherit", "pipe"] });
+            let stderr = "";
+            proc.stderr?.on("data", (chunk) => {
+                stderr += String(chunk);
+            });
+            proc.on("error", (error) => {
+                reject(error);
+            });
+            proc.on("close", (code) => {
+                if (code === 0) {
+                    resolve();
+                    return;
+                }
+                reject(new MeerkatError("ARCHIVE_EXTRACT_FAILED", `${command} failed with code ${code}: ${stderr.trim()}`));
+            });
+        });
+    }
+    static async extractZip(archivePath, destinationDir) {
+        try {
+            await MeerkatClient.runCommand("tar", ["-xf", archivePath, "-C", destinationDir]);
+            return;
+        }
+        catch (error) {
+            await MeerkatClient.runCommand("powershell", [
+                "-NoProfile",
+                "-Command",
+                `Expand-Archive -LiteralPath '${archivePath.replaceAll("'", "''")}' -DestinationPath '${destinationDir.replaceAll("'", "''")}' -Force`,
+            ]);
+        }
+    }
+    static async ensureDownloadedBinary() {
+        const { target, archiveExt, binaryName } = MeerkatClient.platformTarget();
+        const version = CONTRACT_VERSION;
+        const asset = `${MEERKAT_RELEASE_BINARY}-v${version}-${target}.${archiveExt}`;
+        const url = `https://github.com/${MEERKAT_REPO}/releases/download/v${version}/${asset}`;
+        const baseDir = path.join(MEERKAT_BINARY_CACHE_ROOT, `v${version}`, target);
+        mkdirSync(baseDir, { recursive: true });
+        const cached = path.join(baseDir, binaryName);
+        if (existsSync(cached)) {
+            return cached;
+        }
+        const response = await fetch(url);
+        if (!response.ok) {
+            throw new MeerkatError("BINARY_DOWNLOAD_FAILED", `Failed to download binary from ${url} (HTTP ${response.status})`);
+        }
+        const arrayBuffer = await response.arrayBuffer();
+        const archivePath = path.join(baseDir, asset);
+        writeFileSync(archivePath, Buffer.from(arrayBuffer));
+        try {
+            if (archiveExt === "tar.gz") {
+                await MeerkatClient.runCommand("tar", ["-xzf", archivePath, "-C", baseDir]);
+            }
+            else {
+                await MeerkatClient.extractZip(archivePath, baseDir);
+            }
+        }
+        catch (error) {
+            throw new MeerkatError("BINARY_DOWNLOAD_EXTRACT_FAILED", `Failed to extract ${archivePath}: ${String(error)}`);
+        }
+        finally {
+            try {
+                unlinkSync(archivePath);
+            }
+            catch { /* best-effort cleanup */ }
+        }
+        if (process.platform !== "win32") {
+            chmodSync(cached, 0o755);
+        }
+        return cached;
+    }
+    static async resolveBinaryPath(requestedPath) {
+        const overridden = process.env.MEERKAT_BIN_PATH?.trim();
+        if (overridden) {
+            const candidate = MeerkatClient.resolveCandidatePath(overridden);
+            if (!candidate) {
+                throw new MeerkatError("BINARY_NOT_FOUND", `Binary not found at MEERKAT_BIN_PATH='${overridden}'. Set it to a valid executable.`);
+            }
+            return {
+                command: candidate,
+                useLegacySubcommand: path.basename(candidate) === "rkat",
+            };
+        }
+        if (requestedPath !== "rkat-rpc") {
+            const candidate = MeerkatClient.resolveCandidatePath(requestedPath);
+            if (!candidate) {
+                throw new MeerkatError("BINARY_NOT_FOUND", `Binary not found at '${requestedPath}'. Set rkatPath to a valid path or use MEERKAT_BIN_PATH.`);
+            }
+            return {
+                command: candidate,
+                useLegacySubcommand: path.basename(candidate) === "rkat",
+            };
+        }
+        const defaultBinary = MeerkatClient.commandPath("rkat-rpc");
+        if (defaultBinary) {
+            return {
+                command: defaultBinary,
+                useLegacySubcommand: false,
+            };
+        }
+        try {
+            const downloaded = await MeerkatClient.ensureDownloadedBinary();
+            return { command: downloaded, useLegacySubcommand: false };
+        }
+        catch (error) {
+            const legacy = MeerkatClient.commandPath("rkat");
+            if (legacy) {
+                return { command: legacy, useLegacySubcommand: true };
+            }
+            if (error instanceof MeerkatError)
+                throw error;
+            throw new MeerkatError("BINARY_NOT_FOUND", `Could not find '${MEERKAT_RELEASE_BINARY}' and auto-download failed.`);
+        }
+    }
+    async connect(options) {
+        if (options?.realmId && options?.isolated) {
+            throw new MeerkatError("INVALID_ARGS", "realmId and isolated cannot both be set");
+        }
+        const resolved = await MeerkatClient.resolveBinaryPath(this.rkatPath);
+        this.rkatPath = resolved.command;
+        const args = [];
+        const legacyRequiresNewBinary = Boolean(options?.isolated ||
+            options?.realmId ||
+            options?.instanceId ||
+            options?.realmBackend ||
+            options?.stateRoot ||
+            options?.contextRoot ||
+            options?.userConfigRoot);
+        if (resolved.useLegacySubcommand) {
+            if (legacyRequiresNewBinary) {
+                throw new MeerkatError("LEGACY_BINARY_UNSUPPORTED", "Realm/context options require the standalone rkat-rpc binary. Install rkat-rpc and retry.");
+            }
+            args.push("rpc");
+        }
+        else {
+            if (options?.isolated) {
+                args.push("--isolated");
+            }
+            if (options?.realmId) {
+                args.push("--realm", options.realmId);
+            }
+            if (options?.instanceId) {
+                args.push("--instance", options.instanceId);
+            }
+            if (options?.realmBackend) {
+                args.push("--realm-backend", options.realmBackend);
+            }
+            if (options?.stateRoot) {
+                args.push("--state-root", options.stateRoot);
+            }
+            if (options?.contextRoot) {
+                args.push("--context-root", options.contextRoot);
+            }
+            if (options?.userConfigRoot) {
+                args.push("--user-config-root", options.userConfigRoot);
+            }
+        }
+        this.process = spawn(this.rkatPath, args, {
+            stdio: ["pipe", "pipe", "pipe"],
+        });
+        const rl = createInterface({ input: this.process.stdout });
+        rl.on("line", (line) => {
+            try {
+                const response = JSON.parse(line);
+                if ("id" in response &&
+                    typeof response.id === "number" &&
+                    this.pendingRequests.has(response.id)) {
+                    const pending = this.pendingRequests.get(response.id);
+                    this.pendingRequests.delete(response.id);
+                    const error = response.error;
+                    if (error) {
+                        pending.reject(new MeerkatError(String(error.code ?? "UNKNOWN"), String(error.message ?? "Unknown error")));
+                    }
+                    else {
+                        pending.resolve(response.result ?? {});
+                    }
+                }
+            }
+            catch {
+                // Ignore non-JSON lines
+            }
+        });
+        // Initialize
+        const initResult = (await this.request("initialize", {}));
+        const serverVersion = String(initResult.contract_version ?? "");
+        if (!this.checkVersionCompatible(serverVersion, CONTRACT_VERSION)) {
+            throw new MeerkatError("VERSION_MISMATCH", `Server version ${serverVersion} incompatible with SDK ${CONTRACT_VERSION}`);
+        }
+        // Fetch capabilities
+        const capsResult = (await this.request("capabilities/get", {}));
+        this.capabilities = {
+            contract_version: String(capsResult.contract_version ?? ""),
+            capabilities: (capsResult.capabilities ?? []).map((cap) => ({
+                id: String(cap.id ?? ""),
+                description: String(cap.description ?? ""),
+                status: MeerkatClient.normalizeStatus(cap.status),
+            })),
+        };
+        return this;
+    }
+    async close() {
+        if (this.process) {
+            this.process.kill();
+            this.process = null;
+        }
+    }
+    async createSession(params) {
+        const result = (await this.request("session/create", params));
+        return this.parseRunResult(result);
+    }
+    async startTurn(sessionId, prompt, options) {
+        const result = (await this.request("turn/start", {
+            session_id: sessionId,
+            prompt,
+            ...options,
+        }));
+        return this.parseRunResult(result);
+    }
+    async interrupt(sessionId) {
+        await this.request("turn/interrupt", { session_id: sessionId });
+    }
+    async listSessions() {
+        const result = (await this.request("session/list", {}));
+        return result.sessions ?? [];
+    }
+    async readSession(sessionId) {
+        return (await this.request("session/read", {
+            session_id: sessionId,
+        }));
+    }
+    async archiveSession(sessionId) {
+        await this.request("session/archive", { session_id: sessionId });
+    }
+    async getCapabilities() {
+        if (this.capabilities)
+            return this.capabilities;
+        const result = (await this.request("capabilities/get", {}));
+        return {
+            contract_version: String(result.contract_version ?? ""),
+            capabilities: [],
+        };
+    }
+    hasCapability(capabilityId) {
+        if (!this.capabilities)
+            return false;
+        return this.capabilities.capabilities.some((c) => c.id === capabilityId && c.status === "Available");
+    }
+    requireCapability(capabilityId) {
+        if (!this.hasCapability(capabilityId)) {
+            throw new MeerkatError("CAPABILITY_UNAVAILABLE", `Capability '${capabilityId}' is not available`);
+        }
+    }
+    // --- Config ---
+    async getConfig() {
+        return (await this.request("config/get", {}));
+    }
+    async setConfig(config) {
+        await this.request("config/set", config);
+    }
+    async patchConfig(patch) {
+        return (await this.request("config/patch", patch));
+    }
+    /**
+     * Send a canonical comms command to a session.
+     *
+     * @param sessionId - Target session ID
+     * @param command - Command fields (kind, to, body, intent, params, etc.)
+     * @returns Receipt info on success
+     */
+    async send(sessionId, command) {
+        return (await this.request("comms/send", {
+            session_id: sessionId,
+            ...command,
+        }));
+    }
+    /**
+     * Send a command and open a stream in one call.
+     *
+     * @param sessionId - Target session ID
+     * @param command - Command fields (kind, to, body, etc.)
+     * @returns Receipt and stream info
+     */
+    async sendAndStream(sessionId, command) {
+        return (await this.request("comms/send", {
+            session_id: sessionId,
+            stream: "reserve_interaction",
+            ...command,
+        }));
+    }
+    /**
+     * List peers visible to a session's comms runtime.
+     *
+     * @param sessionId - Target session ID
+     * @returns Object with `{ peers: [...] }`
+     */
+    async peers(sessionId) {
+        return (await this.request("comms/peers", {
+            session_id: sessionId,
+        }));
+    }
+    // --- Internal ---
+    /**
+     * Normalize a CapabilityStatus from the wire.
+     * Available is the string "Available", but other variants are
+     * externally-tagged objects like {"DisabledByPolicy": {"description": "..."}}.
+     * We normalize to the variant name string.
+     */
+    static normalizeStatus(raw) {
+        if (typeof raw === "string")
+            return raw;
+        if (typeof raw === "object" && raw !== null) {
+            const keys = Object.keys(raw);
+            return keys[0] ?? "Unknown";
+        }
+        return String(raw);
+    }
+    request(method, params) {
+        if (!this.process?.stdin) {
+            throw new MeerkatError("NOT_CONNECTED", "Client not connected");
+        }
+        this.requestId++;
+        const id = this.requestId;
+        const request = {
+            jsonrpc: "2.0",
+            id,
+            method,
+            params,
+        };
+        return new Promise((resolve, reject) => {
+            this.pendingRequests.set(id, { resolve, reject });
+            this.process.stdin.write(JSON.stringify(request) + "\n");
+        });
+    }
+    checkVersionCompatible(server, client) {
+        try {
+            const s = server.split(".").map(Number);
+            const c = client.split(".").map(Number);
+            if (s[0] === 0 && c[0] === 0)
+                return s[1] === c[1];
+            return s[0] === c[0];
+        }
+        catch {
+            return false;
+        }
+    }
+    parseRunResult(data) {
+        const usage = data.usage;
+        return {
+            session_id: String(data.session_id ?? ""),
+            session_ref: data.session_ref == null ? undefined : String(data.session_ref),
+            text: String(data.text ?? ""),
+            turns: Number(data.turns ?? 0),
+            tool_calls: Number(data.tool_calls ?? 0),
+            usage: {
+                input_tokens: Number(usage?.input_tokens ?? 0),
+                output_tokens: Number(usage?.output_tokens ?? 0),
+                total_tokens: Number(usage?.total_tokens ?? 0),
+                cache_creation_tokens: usage?.cache_creation_tokens,
+                cache_read_tokens: usage?.cache_read_tokens,
+            },
+            structured_output: data.structured_output,
+            schema_warnings: data.schema_warnings,
+        };
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/generated/errors.d.ts

@@ -0,0 +1,25 @@
+export declare class MeerkatError extends Error {
+    readonly code: string;
+    readonly details?: unknown | undefined;
+    readonly capabilityHint?: {
+        capability_id: string;
+        message: string;
+    } | undefined;
+    constructor(code: string, message: string, details?: unknown | undefined, capabilityHint?: {
+        capability_id: string;
+        message: string;
+    } | undefined);
+}
+export declare class CapabilityUnavailableError extends MeerkatError {
+    constructor(code: string, message: string, details?: unknown, capabilityHint?: {
+        capability_id: string;
+        message: string;
+    });
+}
+export declare class SessionNotFoundError extends MeerkatError {
+    constructor(code: string, message: string);
+}
+export declare class SkillNotFoundError extends MeerkatError {
+    constructor(code: string, message: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/generated/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/generated/errors.ts"],"names":[],"mappings":"AAEA,qBAAa,YAAa,SAAQ,KAAK;aAEnB,IAAI,EAAE,MAAM;aAEZ,OAAO,CAAC,EAAE,OAAO;aACjB,cAAc,CAAC,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;gBAH3D,IAAI,EAAE,MAAM,EAC5B,OAAO,EAAE,MAAM,EACC,OAAO,CAAC,EAAE,OAAO,YAAA,EACjB,cAAc,CAAC,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,YAAA;CAK9E;AAED,qBAAa,0BAA2B,SAAQ,YAAY;gBAC9C,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,EAAE,cAAc,CAAC,EAAE;QAAE,aAAa,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;CAI1H;AAED,qBAAa,oBAAqB,SAAQ,YAAY;gBACxC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI1C;AAED,qBAAa,kBAAmB,SAAQ,YAAY;gBACtC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;CAI1C"}

package/dist/generated/errors.js

@@ -0,0 +1,32 @@
+// Generated error types for Meerkat SDK
+export class MeerkatError extends Error {
+    code;
+    details;
+    capabilityHint;
+    constructor(code, message, details, capabilityHint) {
+        super(message);
+        this.code = code;
+        this.details = details;
+        this.capabilityHint = capabilityHint;
+        this.name = 'MeerkatError';
+    }
+}
+export class CapabilityUnavailableError extends MeerkatError {
+    constructor(code, message, details, capabilityHint) {
+        super(code, message, details, capabilityHint);
+        this.name = 'CapabilityUnavailableError';
+    }
+}
+export class SessionNotFoundError extends MeerkatError {
+    constructor(code, message) {
+        super(code, message);
+        this.name = 'SessionNotFoundError';
+    }
+}
+export class SkillNotFoundError extends MeerkatError {
+    constructor(code, message) {
+        super(code, message);
+        this.name = 'SkillNotFoundError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/generated/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/generated/errors.ts"],"names":[],"mappings":"AAAA,wCAAwC;AAExC,MAAM,OAAO,YAAa,SAAQ,KAAK;IAEnB;IAEA;IACA;IAJlB,YACkB,IAAY,EAC5B,OAAe,EACC,OAAiB,EACjB,cAA2D;QAE3E,KAAK,CAAC,OAAO,CAAC,CAAC;QALC,SAAI,GAAJ,IAAI,CAAQ;QAEZ,YAAO,GAAP,OAAO,CAAU;QACjB,mBAAc,GAAd,cAAc,CAA6C;QAG3E,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,0BAA2B,SAAQ,YAAY;IAC1D,YAAY,IAAY,EAAE,OAAe,EAAE,OAAiB,EAAE,cAA2D;QACvH,KAAK,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC3C,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,YAAY;IACpD,YAAY,IAAY,EAAE,OAAe;QACvC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,YAAY;IAClD,YAAY,IAAY,EAAE,OAAe;QACvC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;QACrB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF"}