@mistweaverco/kulala-core 0.1.0

package/dist/lib/runner/http-client.d.ts

@@ -0,0 +1,61 @@
+/**
+ * HTTP client using node:http, node:https, and node:http2 with timing instrumentation
+ * to match the timings shape previously provided by got (dns, tcp, tls, request, firstByte, total).
+ */
+export type NodeHttpClientTimings = {
+    phases: {
+        dns: number;
+        tcp: number;
+        tls: number;
+        request: number;
+        /** Time from request sent to first byte (server TTFB). */
+        firstByte: number;
+        /** Time from start (t0) to first byte; matches curl time_starttransfer. */
+        startTransfer: number;
+        /** Total time spent on redirect steps (curl time_redirect). 0 if no redirects. */
+        redirect: number;
+        total: number;
+    };
+};
+export type NodeHttpClientResponse = {
+    statusCode: number;
+    headers: Record<string, string>;
+    body: string | Buffer;
+    timings: NodeHttpClientTimings;
+    /** Final resolved URL (after redirects). */
+    url: string;
+    /** performance.now() when first byte of this response was received (for startTransfer from wall start). */
+    firstByteTime: number;
+    /** Present only when at least one redirect occurred (ordered hops, including the final response). */
+    redirectChain?: Array<{
+        statusCode: number;
+        headers: Record<string, string>;
+        body: string | Buffer;
+        timings: NodeHttpClientTimings;
+        url: string;
+    }>;
+};
+export type NodeHttpClientOptions = {
+    url: string;
+    method: string;
+    headers: Record<string, string>;
+    /** Body: string, Buffer, or FormData (multipart). For FormData we encode with form-data-encoder. */
+    body?: string | Buffer | FormData;
+    /** When "HTTP/2", use http2 for https URLs. Otherwise use http/https. */
+    httpVersion?: "HTTP/1.0" | "HTTP/1.1" | "HTTP/2";
+    /** If true, allow insecure TLS (curl --insecure). */
+    insecure?: boolean;
+    /** Request timeout in milliseconds (best-effort; curl --max-time). */
+    timeoutMs?: number;
+    /** Connection timeout in milliseconds (best-effort; curl --connect-timeout). */
+    connectionTimeoutMs?: number;
+    /** Whether to follow redirects (default true). */
+    followRedirects?: boolean;
+    /** Whether to propagate Set-Cookie -> Cookie across redirect hops (default true). */
+    propagateCookiesOnRedirect?: boolean;
+};
+/**
+ * Perform an HTTP request via cURL (spawned), with timing instrumentation.
+ */
+export declare function nodeHttpRequest(options: NodeHttpClientOptions): Promise<NodeHttpClientResponse>;
+//# sourceMappingURL=http-client.d.ts.map

package/dist/lib/runner/http-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-client.d.ts","sourceRoot":"","sources":["../../../src/lib/runner/http-client.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH,MAAM,MAAM,qBAAqB,GAAG;IAClC,MAAM,EAAE;QACN,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,GAAG,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,0DAA0D;QAC1D,SAAS,EAAE,MAAM,CAAC;QAClB,2EAA2E;QAC3E,aAAa,EAAE,MAAM,CAAC;QACtB,kFAAkF;QAClF,QAAQ,EAAE,MAAM,CAAC;QACjB,KAAK,EAAE,MAAM,CAAC;KACf,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,OAAO,EAAE,qBAAqB,CAAC;IAC/B,4CAA4C;IAC5C,GAAG,EAAE,MAAM,CAAC;IACZ,2GAA2G;IAC3G,aAAa,EAAE,MAAM,CAAC;IACtB,qGAAqG;IACrG,aAAa,CAAC,EAAE,KAAK,CAAC;QACpB,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAChC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;QACtB,OAAO,EAAE,qBAAqB,CAAC;QAC/B,GAAG,EAAE,MAAM,CAAC;KACb,CAAC,CAAC;CACJ,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,oGAAoG;IACpG,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;IAClC,yEAAyE;IACzE,WAAW,CAAC,EAAE,UAAU,GAAG,UAAU,GAAG,QAAQ,CAAC;IACjD,qDAAqD;IACrD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sEAAsE;IACtE,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gFAAgF;IAChF,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kDAAkD;IAClD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,qFAAqF;IACrF,0BAA0B,CAAC,EAAE,OAAO,CAAC;CACtC,CAAC;AAiBF;;GAEG;AACH,wBAAsB,eAAe,CACnC,OAAO,EAAE,qBAAqB,GAC7B,OAAO,CAAC,sBAAsB,CAAC,CAsBjC"}

package/dist/lib/runner/http-transport.d.ts

@@ -0,0 +1,5 @@
+import type { NodeHttpClientOptions, NodeHttpClientResponse } from "./http-client";
+export type KulalaHttpTransport = {
+    request(options: NodeHttpClientOptions): Promise<NodeHttpClientResponse>;
+};
+//# sourceMappingURL=http-transport.d.ts.map

package/dist/lib/runner/http-transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http-transport.d.ts","sourceRoot":"","sources":["../../../src/lib/runner/http-transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,eAAe,CAAC;AAEvB,MAAM,MAAM,mBAAmB,GAAG;IAChC,OAAO,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,sBAAsB,CAAC,CAAC;CAC1E,CAAC"}

package/dist/lib/runner/index.d.ts

@@ -0,0 +1,10 @@
+import type { KulalaDocument } from "../parser/types";
+import type { KulalaStdinActionRunLimit } from "../parser/types/stdinparsed";
+import type { KulalaRunOptions, KulalaResponseWrapper } from "./types";
+export type { KulalaRunOptions } from "./types";
+export type { KulalaRequestErrorResponse, KulalaRequestSuccessResponse, KulalaResponseWrapper, } from "./types";
+export declare function runDocument(doc: KulalaDocument, limit?: KulalaStdinActionRunLimit[], options?: KulalaRunOptions): Promise<KulalaResponseWrapper>;
+export declare const KulalaRunner: () => {
+    run: (doc: KulalaDocument, limit?: KulalaStdinActionRunLimit[], options?: KulalaRunOptions) => Promise<void>;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/runner/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/runner/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAEtD,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AAa7E,OAAO,KAAK,EAIV,gBAAgB,EAChB,qBAAqB,EACtB,MAAM,SAAS,CAAC;AAGjB,YAAY,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAChD,YAAY,EACV,0BAA0B,EAC1B,4BAA4B,EAC5B,qBAAqB,GACtB,MAAM,SAAS,CAAC;AAEjB,wBAAsB,WAAW,CAC/B,GAAG,EAAE,cAAc,EACnB,KAAK,CAAC,EAAE,yBAAyB,EAAE,EACnC,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,qBAAqB,CAAC,CA6GhC;AAED,eAAO,MAAM,YAAY;eAGd,cAAc,UACX,yBAAyB,EAAE,YACzB,gBAAgB,KACzB,OAAO,CAAC,IAAI,CAAC;CASnB,CAAC"}

package/dist/lib/runner/scripts.d.ts

@@ -0,0 +1,14 @@
+import type { KulalaBlock } from "./../parser/types/block";
+import type { RunnerResponseLike } from "./types";
+import { type KulalaScript, type KulalaScriptType } from "./../parser/types/script";
+export type ScriptFlowContext = {
+    /** "Execution flow" local headers (not persisted). */
+    globalHeaders: Record<string, string>;
+};
+/** Mirrors JetBrains ContentType (Content-Type header). */
+export type ScriptContentType = {
+    mimeType: string;
+    charset: string;
+};
+export declare const runScripts: (scripts: KulalaScript[], type: KulalaScriptType, block: KulalaBlock, filePath?: string, response?: RunnerResponseLike, vars?: Record<string, string>, flow?: ScriptFlowContext) => Promise<void>;
+//# sourceMappingURL=scripts.d.ts.map

package/dist/lib/runner/scripts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scripts.d.ts","sourceRoot":"","sources":["../../../src/lib/runner/scripts.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAClD,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACtB,MAAM,0BAA0B,CAAC;AAmBlC,MAAM,MAAM,iBAAiB,GAAG;IAC9B,sDAAsD;IACtD,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC,CAAC;AAQF,2DAA2D;AAC3D,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAuWF,eAAO,MAAM,UAAU,GACrB,SAAS,YAAY,EAAE,EACvB,MAAM,gBAAgB,EACtB,OAAO,WAAW,EAClB,WAAW,MAAM,EACjB,WAAW,kBAAkB,EAC7B,OAAO,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC7B,OAAO,iBAAiB,KACvB,OAAO,CAAC,IAAI,CAiId,CAAC"}

package/dist/lib/runner/types.d.ts

@@ -0,0 +1,91 @@
+export type KulalaRequestSuccessResponse = {
+    success: true;
+    status: number;
+    headers: Record<string, string>;
+    /** Final resolved URL (after redirects). */
+    url: string;
+    /** Present only when at least one redirect occurred (ordered hops, including the final response). */
+    redirectChain?: Array<{
+        status: number;
+        headers: Record<string, string>;
+        url: string;
+        body: {
+            type: "text";
+            content: string;
+        } | {
+            type: "json";
+            content: Record<string, unknown>;
+        };
+        timings: {
+            dns: number;
+            tcp: number;
+            tls: number;
+            request: number;
+            redirect: number;
+            firstByte: number;
+            startTransfer: number;
+            total: number;
+        };
+    }>;
+    timings: {
+        dns: number;
+        tcp: number;
+        tls: number;
+        request: number;
+        redirect: number;
+        /** Time from request sent to first byte (server TTFB). */
+        firstByte: number;
+        /** Time from start to first byte; matches curl time_starttransfer. */
+        startTransfer: number;
+        total: number;
+    };
+    body: {
+        type: "text";
+        content: string;
+    } | {
+        type: "json";
+        content: Record<string, unknown>;
+    };
+};
+export type KulalaRequestErrorResponse = {
+    success: false;
+    error: string;
+};
+export type KulalaPromptResponse = {
+    success: false;
+    prompt: true;
+    promptId: string;
+    promptType: string;
+    message: string;
+    inputs: Array<{
+        id: string;
+        label: string;
+        type: "text" | "password" | "url";
+        required?: boolean;
+    }>;
+};
+export type KulalaResponseWrapper = {
+    type: "responses";
+    data: Array<KulalaRequestSuccessResponse | KulalaRequestErrorResponse | KulalaPromptResponse>;
+} | {
+    type: "error";
+    data: Array<KulalaRequestErrorResponse>;
+};
+export type RequestHeaderType = "json" | "form-data" | "form-urlencoded" | "invalid";
+export type VariableResolver = (name: string) => string | undefined;
+export type KulalaRunOptions = {
+    /** Raw document content (for stable ID when filepath is absent). */
+    content?: string;
+    /** Environment name for variable resolution (kuba, etc.). Defaults to "default". */
+    env?: string;
+};
+/** Response-like value passed to scripts (fetch Response or compatible). */
+export type RunnerResponseLike = {
+    body: unknown;
+    statusCode: number;
+    headers: Record<string, string>;
+    timings: {
+        phases: Record<string, number>;
+    };
+};
+//# sourceMappingURL=types.d.ts.map

package/dist/lib/runner/types.d.ts.map

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

package/dist/lib/runner/vendored-curl.generated.d.ts

@@ -0,0 +1,5 @@
+export declare function getVendoredCurl(): Promise<{
+    bytes: Buffer;
+    filename: string;
+} | null>;
+//# sourceMappingURL=vendored-curl.generated.d.ts.map

package/dist/lib/runner/vendored-curl.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vendored-curl.generated.d.ts","sourceRoot":"","sources":["../../../src/lib/runner/vendored-curl.generated.ts"],"names":[],"mappings":"AAOA,wBAAsB,eAAe,IAAI,OAAO,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAG3F"}

package/dist/lib/variables/env-files.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Collect directory paths from startDir upward to root.
+ */
+export declare function dirsUpward(startDir: string): string[];
+/**
+ * Load raw JSON section from http-client.env.json or http-client.private.env.json.
+ * Returns the raw object (not flattened) for the given env key.
+ */
+export declare function loadHttpClientEnvJsonRaw(filePath: string, env: string): Record<string, unknown> | null;
+/**
+ * Load environment variables from system, http-client.env.json, and .env.
+ * Order (later overrides earlier): system env → http-client.env.json (merged from dirs upward, closest wins) → http-client.private.env.json → .env.
+ * Also exposes system env as {{$env.VAR_NAME}} per JetBrains HTTP Client spec.
+ * See https://www.jetbrains.com/help/idea/http-client-variables.html
+ */
+export declare function loadEnvVars(env: string, startDir: string): Record<string, string>;
+//# sourceMappingURL=env-files.d.ts.map

package/dist/lib/variables/env-files.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env-files.d.ts","sourceRoot":"","sources":["../../../src/lib/variables/env-files.ts"],"names":[],"mappings":"AAQA;;GAEG;AACH,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,EAAE,CAUrD;AAED;;;GAGG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,EAChB,GAAG,EAAE,MAAM,GACV,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAWhC;AA2CD;;;;;GAKG;AACH,wBAAgB,WAAW,CACzB,GAAG,EAAE,MAAM,EACX,QAAQ,EAAE,MAAM,GACf,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CA4CxB"}

package/dist/lib/variables/flatten-json.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Flatten nested JSON into dotted path keys (JetBrains-style JSONPath in variables).
+ * - client.host.url from { client: { host: { url: "example.org" } } }
+ * - client.['host.url'] for keys that contain a dot: { client: { "host.url": "example.org" } }
+ */
+export declare function flattenToDotPaths(obj: unknown, prefix: string, out: Record<string, string>): void;
+//# sourceMappingURL=flatten-json.d.ts.map

package/dist/lib/variables/flatten-json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatten-json.d.ts","sourceRoot":"","sources":["../../../src/lib/variables/flatten-json.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,OAAO,EACZ,MAAM,EAAE,MAAM,EACd,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC1B,IAAI,CAwBN"}

package/dist/lib/variables/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Variable resolution and substitution for HTTP requests.
+ * - Stable document ID (filepath or content hash) so variables don't leak between documents.
+ * - Kuba: traverse up for kuba.yaml, run `kuba show --env <env> --output json`.
+ * - Env files: system env, http-client.env.json, http-client.private.env.json, .env (by env name).
+ * - Persistence: global, document-scoped, and request-scoped variables from SQLite.
+ * - System env as {{$env.VAR}}: JetBrains-style (https://www.jetbrains.com/help/idea/http-client-variables.html).
+ * - Dynamic variables: $uuid, $random.uuid, $timestamp, $isoTimestamp, $date, $randomInt (0..1000).
+ * - Request variables: {{REQUEST_NAME.response.body.$.field}}, {{REQUEST_NAME.response.headers.Name}}.
+ * - JSONPath-style in env/kuba: nested JSON flattened to dotted paths (client.host.url, client.['host.url']).
+ * - Substitution: {{variableName}} or compound paths; optional spaces {{ var }} in URL, headers, body.
+ * - In-file @ variables: @name=value before the first ### or in a block preamble (JetBrains).
+ */
+export { getStableDocumentId } from "./stable-id";
+export { findKubaYamlDir, getKubaEnv, isKubaInPath } from "./kuba";
+export { loadEnvVars } from "./env-files";
+export { getMagicVariables } from "./magic";
+export { resolveVariables, type HttpFileVariableSources } from "./resolve";
+export { substituteInString, substituteInStringAsync, substituteInObject, substituteInObjectAsync, } from "./substitute";
+export { resolveRequestVariable, isRequestVariableKey, type PreviousResponse, } from "./request-vars";
+export { OAuth2Manager } from "../auth/oauth2/manager";
+//# sourceMappingURL=index.d.ts.map

package/dist/lib/variables/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/lib/variables/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AACnE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,OAAO,EAAE,gBAAgB,EAAE,KAAK,uBAAuB,EAAE,MAAM,WAAW,CAAC;AAC3E,OAAO,EACL,kBAAkB,EAClB,uBAAuB,EACvB,kBAAkB,EAClB,uBAAuB,GACxB,MAAM,cAAc,CAAC;AACtB,OAAO,EACL,sBAAsB,EACtB,oBAAoB,EACpB,KAAK,gBAAgB,GACtB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,aAAa,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/lib/variables/kuba.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Traverse upward from startDir to find a directory containing kuba.yaml.
+ */
+export declare function findKubaYamlDir(startDir: string): string | null;
+/**
+ * Check if `kuba` is available in PATH
+ */
+export declare function isKubaInPath(): boolean;
+/**
+ * Run `kuba show --env <env> --output json` in dir and return parsed env vars.
+ * Returns null if kuba.yaml not in dir, kuba not in PATH, or command fails.
+ * If kuba.yaml exists but kuba is not in PATH, writes a message to stderr.
+ */
+export declare function getKubaEnv(env: string, dir: string): Promise<Record<string, string> | null>;
+//# sourceMappingURL=kuba.d.ts.map

package/dist/lib/variables/kuba.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kuba.d.ts","sourceRoot":"","sources":["../../../src/lib/variables/kuba.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,wBAAgB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAW/D;AAED;;GAEG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED;;;;GAIG;AACH,wBAAsB,UAAU,CAC9B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,GACV,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,CAoCxC"}

package/dist/lib/variables/magic.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Dynamic variables per JetBrains HTTP Client spec.
+ * https://www.jetbrains.com/help/idea/http-client-variables.html#dynamic-variables
+ * Generated fresh per request. Optional spaces around braces kept: {{ $uuid }}.
+ */
+export declare function getMagicVariables(): Record<string, string>;
+//# sourceMappingURL=magic.d.ts.map

package/dist/lib/variables/magic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"magic.d.ts","sourceRoot":"","sources":["../../../src/lib/variables/magic.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAW1D"}

package/dist/lib/variables/request-vars.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Request variable resolution: {{REQUEST_NAME.response.body.$.path}} and {{REQUEST_NAME.response.headers.HeaderName}}.
+ * See https://neovim.getkulala.net/docs/usage/request-variables
+ */
+export type PreviousResponse = {
+    body: {
+        type: "text";
+        content: string;
+    } | {
+        type: "json";
+        content: Record<string, unknown>;
+    };
+    headers: Record<string, string>;
+};
+/**
+ * Resolve a request variable key against previous run results.
+ * Key forms: REQUEST_NAME.response.body.$.path (JSON fields on the parsed body), REQUEST_NAME.response.headers.HeaderName, REQUEST_NAME.response.headers['Header Name'].
+ * Returns string value or undefined if not found / not a request var.
+ */
+export declare function resolveRequestVariable(key: string, previousResults: Map<string, PreviousResponse>): string | undefined;
+/**
+ * Check if a variable key looks like a request variable reference.
+ */
+export declare function isRequestVariableKey(key: string): boolean;
+//# sourceMappingURL=request-vars.d.ts.map

package/dist/lib/variables/request-vars.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request-vars.d.ts","sourceRoot":"","sources":["../../../src/lib/variables/request-vars.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,gBAAgB,GAAG;IAC7B,IAAI,EACA;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,GACjC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IACvD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC,CAAC;AAgBF;;;;GAIG;AACH,wBAAgB,sBAAsB,CACpC,GAAG,EAAE,MAAM,EACX,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,GAC7C,MAAM,GAAG,SAAS,CAqCpB;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAGzD"}

package/dist/lib/variables/resolve.d.ts

@@ -0,0 +1,16 @@
+export type HttpFileVariableSources = {
+    /** @name=value lines before the first ### in the .http file (or imported file). */
+    fileHeader?: Record<string, string>;
+    /** @name=value lines in the current block preamble before the request line. */
+    blockPreamble?: Record<string, string>;
+};
+/**
+ * Resolve all variables for a request.
+ * Order (later overrides earlier): kuba → @-lines from .http (file header + block preamble) →
+ * system/env files (http-client.env.json, .env) → persistence (global → document → request) →
+ * magic variables ($uuid, $timestamp, etc.).
+ * See https://neovim.getkulala.net/docs/usage/magic-variables and
+ * https://neovim.getkulala.net/docs/usage/dotenv-and-http-client.env.json-support
+ */
+export declare function resolveVariables(env: string, stableDocId: string, blockName: string, startDir: string, httpFileVars?: HttpFileVariableSources): Promise<Record<string, string>>;
+//# sourceMappingURL=resolve.d.ts.map

package/dist/lib/variables/resolve.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve.d.ts","sourceRoot":"","sources":["../../../src/lib/variables/resolve.ts"],"names":[],"mappings":"AAgBA,MAAM,MAAM,uBAAuB,GAAG;IACpC,mFAAmF;IACnF,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACpC,+EAA+E;IAC/E,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACxC,CAAC;AAEF;;;;;;;GAOG;AACH,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,MAAM,EACX,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,YAAY,CAAC,EAAE,uBAAuB,GACrC,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAqDjC"}

package/dist/lib/variables/stable-id.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Build a stable document ID so variables from one HTTP document don't leak into another.
+ * When there is no physical file, we can't rely on filepath; use a hash of the content instead.
+ */
+export declare function getStableDocumentId(filepath?: string, content?: string): string;
+//# sourceMappingURL=stable-id.d.ts.map

package/dist/lib/variables/stable-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stable-id.d.ts","sourceRoot":"","sources":["../../../src/lib/variables/stable-id.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM,CASR"}

package/dist/lib/variables/substitute.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Replace {{variableName}} or {{ variableName }} in a string with values from vars.
+ * Supports simple names (e.g. API_KEY) and compound request vars (e.g. REQUEST_ONE.response.body.$.token).
+ * Optional whitespace around the variable name is allowed.
+ * Unknown variables are replaced with empty string.
+ * If resolver is provided, it is used for missing keys (e.g. request variables).
+ *
+ * Note: For $auth.token() and $auth.idToken() calls, use substituteInStringAsync instead.
+ */
+export declare function substituteInString(template: string, vars: Record<string, string>, resolver?: (name: string) => string | undefined): string;
+/**
+ * Async version that handles $auth.token() and $auth.idToken() calls.
+ * Also supports all regular variable substitution.
+ *
+ * This function properly handles multiple occurrences of the same variable.
+ */
+export declare function substituteInStringAsync(template: string, vars: Record<string, string>, resolver?: (name: string) => string | undefined, authResolver?: (func: "token" | "idToken", authId: string) => Promise<string | undefined>): Promise<string>;
+/**
+ * Recursively substitute {{var}} in any string values in obj (for request body).
+ *
+ * Note: For $auth.token() and $auth.idToken() calls, use substituteInObjectAsync instead.
+ */
+export declare function substituteInObject(obj: unknown, vars: Record<string, string>, resolver?: (name: string) => string | undefined): unknown;
+/**
+ * Async version that handles $auth.token() and $auth.idToken() calls.
+ */
+export declare function substituteInObjectAsync(obj: unknown, vars: Record<string, string>, resolver?: (name: string) => string | undefined, authResolver?: (func: "token" | "idToken", authId: string) => Promise<string | undefined>): Promise<unknown>;
+//# sourceMappingURL=substitute.d.ts.map

package/dist/lib/variables/substitute.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"substitute.d.ts","sourceRoot":"","sources":["../../../src/lib/variables/substitute.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAC9C,MAAM,CAmBR;AAED;;;;;GAKG;AACH,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,EAC/C,YAAY,CAAC,EAAE,CACb,IAAI,EAAE,OAAO,GAAG,SAAS,EACzB,MAAM,EAAE,MAAM,KACX,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,GAC/B,OAAO,CAAC,MAAM,CAAC,CA6CjB;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAChC,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,GAC9C,OAAO,CAeT;AAED;;GAEG;AACH,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,OAAO,EACZ,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC5B,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,EAC/C,YAAY,CAAC,EAAE,CACb,IAAI,EAAE,OAAO,GAAG,SAAS,EACzB,MAAM,EAAE,MAAM,KACX,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,GAC/B,OAAO,CAAC,OAAO,CAAC,CAmBlB"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@mistweaverco/kulala-core",
+  "version": "0.1.0",
+  "type": "module",
+  "private": false,
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/mistweaverco/kulala-core.git"
+  },
+  "homepage": "https://github.com/mistweaverco/kulala-core#readme",
+  "bugs": {
+    "url": "https://github.com/mistweaverco/kulala-core/issues"
+  },
+  "engines": {
+    "bun": ">=1.0.0"
+  },
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "format": "prettier --write .",
+    "lint": "prettier --check . && eslint .",
+    "test": "bun test",
+    "build": "bun run build:js && bun run build:types",
+    "build:js": "bun build src/index.ts --outdir dist --format esm --target bun --sourcemap",
+    "build:types": "tsc -p tsconfig.build.json",
+    "prepack": "cp ./../../README.md . && cp ./../../LICENSE . && bun run build"
+  },
+  "pkg": {
+    "assets": [
+      "../../vendor/curl/**/*"
+    ]
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}