@dexcost/sdk 0.2.0

package/dist/cloud-detect.js

@@ -0,0 +1,545 @@
+/**
+ * Cloud-environment detection for egress pricing.
+ *
+ * Mirrors `python/src/dexcost/cloud_detect.py` exactly — env-var names,
+ * DMI strings, and IMDS endpoints have all been verified against May-2026
+ * docs and MUST NOT be changed in this port.
+ *
+ * Phase 1a — env-var detection  (sub-millisecond, synchronous).
+ * Phase 1b — DMI vendor check   (~1 ms, Linux-only — silent no-op elsewhere).
+ * Phase 2  — background metadata probe (fire-and-forget Promise, ~250 ms
+ *            budget, never blocks `dexcost.init()`).
+ *
+ * Notes — research May 2026:
+ * - AWS Lambda / Fargate / App Runner set `AWS_REGION` automatically; ECS
+ *   (Fargate and on-EC2) also sets `ECS_CONTAINER_METADATA_URI_V4`.
+ * - Azure Container Apps embeds the region in `CONTAINER_APP_HOSTNAME` and
+ *   `CONTAINER_APP_ENV_DNS_SUFFIX` as `<host>.<REGION>.azurecontainerapps.io`.
+ * - GCP Cloud Run / Cloud Functions Gen2 / App Engine do NOT expose a region
+ *   env var; region must come from the metadata server (Phase 2).
+ * - AWS IMDSv2 has a default HTTP hop-limit of 1, which prevents Docker/Pod
+ *   containers from reaching the metadata service; the probe fails silent.
+ */
+import { readFileSync } from "node:fs";
+// ---------------------------------------------------------------------------
+// Constants
+// ---------------------------------------------------------------------------
+const PROBE_TIMEOUT_MS = 250;
+/** DMI fields read from /sys/class/dmi/id/<field> (Linux only). */
+const DMI_FIELDS = [
+    "sys_vendor",
+    "board_vendor",
+    "product_name",
+    "chassis_asset_tag",
+    "bios_vendor",
+    "product_serial",
+];
+/**
+ * DMI rules — ordered from most-specific to most-generic; the first match
+ * wins. Transcribed from cloud-init's ds-identify (canonical) plus provider
+ * documentation, verified May 2026.
+ *
+ * Canonical signals (chassis_asset_tag / product_name) appear first so
+ * they win over loose sys_vendor backups when both are present.
+ */
+const DMI_RULES = [
+    // Canonical signals first
+    { field: "chassis_asset_tag", needle: "oraclecloud.com", mode: "eq", provider: "oci" },
+    { field: "chassis_asset_tag", needle: "7783-7084-3265-9085-8269-3286-77", mode: "eq", provider: "azure" },
+    { field: "product_name", needle: "google compute engine", mode: "eq", provider: "gcp" },
+    { field: "product_name", needle: "alibaba cloud ecs", mode: "eq", provider: "alibaba" },
+    // sys_vendor exact matches
+    { field: "sys_vendor", needle: "amazon ec2", mode: "eq", provider: "aws" },
+    { field: "sys_vendor", needle: "digitalocean", mode: "eq", provider: "digitalocean" },
+    { field: "sys_vendor", needle: "hetzner", mode: "eq", provider: "hetzner" },
+    { field: "sys_vendor", needle: "vultr", mode: "eq", provider: "vultr" },
+    { field: "sys_vendor", needle: "scaleway", mode: "eq", provider: "scaleway" },
+    { field: "sys_vendor", needle: "microsoft corporation", mode: "eq", provider: "azure" },
+    // Looser substring backups
+    { field: "sys_vendor", needle: "amazon", mode: "contains", provider: "aws" },
+    { field: "sys_vendor", needle: "google", mode: "contains", provider: "gcp" },
+    { field: "sys_vendor", needle: "alibaba cloud", mode: "contains", provider: "alibaba" },
+    { field: "sys_vendor", needle: "ovh", mode: "contains", provider: "ovh" },
+];
+// ---------------------------------------------------------------------------
+// Module-level result (single-threaded JS — no lock needed)
+// ---------------------------------------------------------------------------
+let _result = { provider: null, region: null, source: "none" };
+let _backgroundPromise = null;
+export function getCloudEnv() {
+    return _result;
+}
+function _setResult(env) {
+    _result = env;
+}
+/**
+ * Test-only — force the resolved CloudEnv to a known value. Used by
+ * downstream finalize tests (Phase D Task 10) that need a deterministic
+ * egress rate without actually probing IMDS or reading DMI. The
+ * `_for_tests` suffix marks this as not-public-API.
+ */
+export function _setResultForTests(env) {
+    _setResult(env);
+}
+// Test-only — reset module state.
+export function _resetCloudDetectForTests() {
+    _result = { provider: null, region: null, source: "none" };
+    _backgroundPromise = null;
+}
+// ---------------------------------------------------------------------------
+// Phase 1a — environment variable detection
+// ---------------------------------------------------------------------------
+const _AZ_CA_REGION_RE = /\.([a-z0-9-]+)\.azurecontainerapps\.io$/i;
+function _azureContainerAppsRegion() {
+    for (const name of ["CONTAINER_APP_HOSTNAME", "CONTAINER_APP_ENV_DNS_SUFFIX"]) {
+        const value = process.env[name];
+        if (!value)
+            continue;
+        const match = _AZ_CA_REGION_RE.exec(value);
+        if (match && match[1])
+            return match[1].toLowerCase();
+    }
+    return null;
+}
+function _detectEnv() {
+    const env = process.env;
+    // ── GPU / ML clouds (zero egress) ───────────────────────────────────────
+    // Detection prevents the universal $0.09/GB default from over-attributing
+    // on platforms whose marketing point is $0 egress.
+    // Modal (modal.com/docs).
+    if (env.MODAL_TASK_ID || env.MODAL_IMAGE_ID) {
+        return { provider: "modal", region: env.MODAL_REGION || null, source: "env" };
+    }
+    // RunPod (docs.runpod.io).
+    if (env.RUNPOD_POD_ID || env.RUNPOD_POD_HOSTNAME) {
+        return { provider: "runpod", region: env.RUNPOD_DC_ID || null, source: "env" };
+    }
+    // ── PaaS app platforms ──────────────────────────────────────────────────
+    // Render — RENDER=true, RENDER_SERVICE_ID. No region env var.
+    if (env.RENDER || env.RENDER_SERVICE_ID) {
+        return { provider: "render", region: null, source: "env" };
+    }
+    // Railway — RAILWAY_PROJECT_ID + RAILWAY_REPLICA_REGION (NOT RAILWAY_REGION).
+    if (env.RAILWAY_PROJECT_ID || env.RAILWAY_ENVIRONMENT_ID) {
+        return {
+            provider: "railway",
+            region: env.RAILWAY_REPLICA_REGION || null,
+            source: "env",
+        };
+    }
+    // Heroku — DYNO ("web.1" / "worker.1" / "scheduler.x").
+    if (env.DYNO) {
+        return { provider: "heroku", region: null, source: "env" };
+    }
+    // Koyeb — KOYEB_APP_NAME / KOYEB_SERVICE_NAME plus KOYEB_REGION (runtime).
+    if (env.KOYEB_SERVICE_NAME || env.KOYEB_APP_NAME) {
+        return { provider: "koyeb", region: env.KOYEB_REGION || null, source: "env" };
+    }
+    // ── Fly.io ──────────────────────────────────────────────────────────────
+    if (env.FLY_REGION || env.FLY_APP_NAME) {
+        return { provider: "fly", region: env.FLY_REGION || null, source: "env" };
+    }
+    // ── Vercel ──────────────────────────────────────────────────────────────
+    // Vercel also exports AWS_REGION; detecting Vercel first surfaces the
+    // platform's $0-egress attribution rather than the underlying AWS rate.
+    if (env.VERCEL || env.VERCEL_REGION) {
+        return { provider: "vercel", region: env.VERCEL_REGION || null, source: "env" };
+    }
+    // ── AWS ─────────────────────────────────────────────────────────────────
+    if (env.AWS_LAMBDA_FUNCTION_NAME ||
+        env.AWS_EXECUTION_ENV ||
+        env.ECS_CONTAINER_METADATA_URI_V4 ||
+        env.ECS_CONTAINER_METADATA_URI ||
+        env.AWS_REGION ||
+        env.AWS_DEFAULT_REGION) {
+        const region = env.AWS_REGION || env.AWS_DEFAULT_REGION || null;
+        return { provider: "aws", region, source: "env" };
+    }
+    // ── Azure ───────────────────────────────────────────────────────────────
+    if (env.WEBSITE_SITE_NAME || env.FUNCTIONS_WORKER_RUNTIME || env.CONTAINER_APP_NAME) {
+        const region = env.REGION_NAME || _azureContainerAppsRegion() || null;
+        return { provider: "azure", region, source: "env" };
+    }
+    // ── GCP ─────────────────────────────────────────────────────────────────
+    // K_SERVICE / K_CONFIGURATION are reserved by Cloud Run + Cloud Functions
+    // Gen2; FUNCTION_TARGET / FUNCTION_NAME by Cloud Functions Gen1.
+    if (env.K_SERVICE ||
+        env.K_CONFIGURATION ||
+        env.GAE_ENV ||
+        env.FUNCTION_TARGET ||
+        env.FUNCTION_NAME) {
+        return { provider: "gcp", region: null, source: "env" };
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Phase 1b — DMI check (Linux only; silent no-op elsewhere)
+// ---------------------------------------------------------------------------
+/**
+ * Read all DMI fields we care about. Missing files / non-Linux platforms
+ * silently yield an empty record.
+ */
+function _readDmi() {
+    if (process.platform !== "linux")
+        return {};
+    const result = {};
+    for (const field of DMI_FIELDS) {
+        try {
+            const raw = readFileSync(`/sys/class/dmi/id/${field}`, "utf-8");
+            result[field] = raw.trim().toLowerCase();
+        }
+        catch {
+            // Missing file or read error → skip this field.
+        }
+    }
+    return result;
+}
+// Test seam — allow tests to override `_readDmi` behaviour.
+let _readDmiOverride = null;
+export function _setReadDmiForTests(fn) {
+    _readDmiOverride = fn;
+}
+function _readDmiSafe() {
+    if (_readDmiOverride !== null)
+        return _readDmiOverride();
+    return _readDmi();
+}
+function _detectDmi() {
+    const dmi = _readDmiSafe();
+    for (const rule of DMI_RULES) {
+        const value = dmi[rule.field];
+        if (!value)
+            continue;
+        if (rule.mode === "eq" && value === rule.needle) {
+            return { provider: rule.provider, region: null, source: "dmi" };
+        }
+        if (rule.mode === "contains" && value.includes(rule.needle)) {
+            return { provider: rule.provider, region: null, source: "dmi" };
+        }
+    }
+    return null;
+}
+// ---------------------------------------------------------------------------
+// Phase 2 — metadata probes
+// ---------------------------------------------------------------------------
+/**
+ * Strip a GCP metadata-server `projects/.../<X>/<name>` response to a region.
+ *
+ * Zone form  (`projects/123/zones/us-central1-a`) → `us-central1` when
+ *   `dropZoneLetter=true`.
+ * Region form (`projects/123/regions/us-central1`) → `us-central1` when
+ *   `dropZoneLetter=false`.
+ */
+export function _gcpPathToRegion(value, dropZoneLetter) {
+    if (!value)
+        return null;
+    const parts = value.split("/");
+    const last = parts[parts.length - 1] || "";
+    if (!last)
+        return null;
+    if (dropZoneLetter) {
+        if (!last.includes("-"))
+            return null;
+        return last.substring(0, last.lastIndexOf("-"));
+    }
+    return last;
+}
+/** Hookable fetch — tests replace this to avoid real network calls. */
+let _fetchImpl = (...args) => fetch(...args);
+export function _setFetchForTests(impl) {
+    _fetchImpl = impl ?? ((...args) => fetch(...args));
+}
+async function _probeAws() {
+    try {
+        const tokenResp = await _fetchImpl("http://169.254.169.254/latest/api/token", {
+            method: "PUT",
+            headers: { "X-aws-ec2-metadata-token-ttl-seconds": "21600" },
+            signal: AbortSignal.timeout(PROBE_TIMEOUT_MS),
+        });
+        if (!tokenResp.ok)
+            return null;
+        const token = (await tokenResp.text()).trim();
+        if (!token)
+            return null;
+        const regResp = await _fetchImpl("http://169.254.169.254/latest/meta-data/placement/region", {
+            headers: { "X-aws-ec2-metadata-token": token },
+            signal: AbortSignal.timeout(PROBE_TIMEOUT_MS),
+        });
+        if (!regResp.ok)
+            return null;
+        const region = (await regResp.text()).trim();
+        // Decision #3: extract instance-type in the same probe. Wrap separately
+        // so a failure here doesn't lose the region we already resolved.
+        let instanceType = null;
+        try {
+            const itResp = await _fetchImpl("http://169.254.169.254/latest/meta-data/instance-type", {
+                headers: { "X-aws-ec2-metadata-token": token },
+                signal: AbortSignal.timeout(PROBE_TIMEOUT_MS),
+            });
+            if (itResp.ok) {
+                const body = (await itResp.text()).trim();
+                instanceType = body || null;
+            }
+        }
+        catch {
+            // Fail-silent — keep region even if instance-type errors.
+        }
+        return {
+            provider: "aws",
+            region: region || null,
+            source: "imds",
+            instanceType,
+        };
+    }
+    catch {
+        return null;
+    }
+}
+async function _probeGcp() {
+    const headers = { "Metadata-Flavor": "Google" };
+    let region = null;
+    // Try /region first (works on Cloud Run / Cloud Functions Gen2 and GCE).
+    try {
+        const resp = await _fetchImpl("http://metadata.google.internal/computeMetadata/v1/instance/region", { headers, signal: AbortSignal.timeout(PROBE_TIMEOUT_MS) });
+        if (resp.ok) {
+            const body = (await resp.text()).trim();
+            region = _gcpPathToRegion(body, false);
+        }
+    }
+    catch {
+        region = null;
+    }
+    if (region === null) {
+        try {
+            const resp = await _fetchImpl("http://metadata.google.internal/computeMetadata/v1/instance/zone", { headers, signal: AbortSignal.timeout(PROBE_TIMEOUT_MS) });
+            if (!resp.ok)
+                return null;
+            const body = (await resp.text()).trim();
+            region = _gcpPathToRegion(body, true);
+        }
+        catch {
+            return null;
+        }
+    }
+    // Decision #3: machine-type lives under /instance/machine-type and shares
+    // the projects/.../machineTypes/<name> path shape — strip the prefix to
+    // get e.g. "n2-standard-2". Fail-silent so a missing endpoint does not
+    // discard the region we already resolved.
+    let instanceType = null;
+    try {
+        const resp = await _fetchImpl("http://metadata.google.internal/computeMetadata/v1/instance/machine-type", { headers, signal: AbortSignal.timeout(PROBE_TIMEOUT_MS) });
+        if (resp.ok) {
+            const body = (await resp.text()).trim();
+            if (body) {
+                const parts = body.split("/");
+                const last = parts[parts.length - 1] || "";
+                instanceType = last || null;
+            }
+        }
+    }
+    catch {
+        // fail-silent
+    }
+    return { provider: "gcp", region, source: "imds", instanceType };
+}
+async function _probeAzure() {
+    try {
+        const resp = await _fetchImpl("http://169.254.169.254/metadata/instance?api-version=2021-02-01", {
+            headers: { Metadata: "true" },
+            signal: AbortSignal.timeout(PROBE_TIMEOUT_MS),
+        });
+        if (!resp.ok)
+            return null;
+        const payload = (await resp.json());
+        const region = payload.compute?.location || null;
+        // Decision #3: vmSize is already in the same IMDS payload — zero extra
+        // HTTP cost. Returns null when absent (some non-VM Azure runtimes).
+        const instanceType = payload.compute?.vmSize || null;
+        return { provider: "azure", region, source: "imds", instanceType };
+    }
+    catch {
+        return null;
+    }
+}
+async function _probeOci() {
+    try {
+        const resp = await _fetchImpl("http://169.254.169.254/opc/v2/instance/canonicalRegionName", {
+            headers: { Authorization: "Bearer Oracle" },
+            signal: AbortSignal.timeout(PROBE_TIMEOUT_MS),
+        });
+        if (!resp.ok)
+            return null;
+        const region = (await resp.text()).trim().toLowerCase();
+        return { provider: "oci", region: region || null, source: "imds" };
+    }
+    catch {
+        return null;
+    }
+}
+async function _probeDigitalOcean() {
+    try {
+        const resp = await _fetchImpl("http://169.254.169.254/metadata/v1/region", {
+            signal: AbortSignal.timeout(PROBE_TIMEOUT_MS),
+        });
+        if (!resp.ok)
+            return null;
+        const region = (await resp.text()).trim().toLowerCase();
+        return { provider: "digitalocean", region: region || null, source: "imds" };
+    }
+    catch {
+        return null;
+    }
+}
+async function _probeAlibaba() {
+    try {
+        const resp = await _fetchImpl("http://100.100.100.200/latest/meta-data/region-id", {
+            signal: AbortSignal.timeout(PROBE_TIMEOUT_MS),
+        });
+        if (!resp.ok)
+            return null;
+        const region = (await resp.text()).trim().toLowerCase();
+        return { provider: "alibaba", region: region || null, source: "imds" };
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Provider hint → metadata probe. Mutable so tests can stub individual
+ * probes via `monkeypatch.setitem` (Python idiom) → `_PROBES["aws"] = …`.
+ */
+export const _PROBES = {
+    aws: _probeAws,
+    gcp: _probeGcp,
+    azure: _probeAzure,
+    oci: _probeOci,
+    digitalocean: _probeDigitalOcean,
+    alibaba: _probeAlibaba,
+};
+/**
+ * Phase 2 fanout providers. When DMI doesn't pre-classify, we race AWS/GCP/
+ * Azure in parallel — adding OCI/DO/Alibaba would lengthen worst-case wait
+ * and hit the wrong metadata server (DO uses the same 169.254.169.254 IP).
+ */
+export const _FANOUT_PROBES = ["aws", "gcp", "azure"];
+async function _runProbe(providerHint) {
+    if (providerHint && providerHint in _PROBES) {
+        const probe = _PROBES[providerHint];
+        if (probe) {
+            const env = await probe();
+            return env ?? { provider: providerHint, region: null, source: "imds" };
+        }
+    }
+    // Race the fanout — first non-null wins.
+    const promises = _FANOUT_PROBES.map((name) => _PROBES[name]().then((env) => (env ? env : null)));
+    // Promise.race resolves on first settle; we want first NON-null. Use a
+    // promise pattern where each non-null result resolves the outer promise.
+    const result = await new Promise((resolve) => {
+        let pending = promises.length;
+        let settled = false;
+        for (const p of promises) {
+            p.then((env) => {
+                if (settled)
+                    return;
+                if (env !== null) {
+                    settled = true;
+                    resolve(env);
+                    return;
+                }
+                pending -= 1;
+                if (pending === 0 && !settled) {
+                    settled = true;
+                    resolve(null);
+                }
+            }, () => {
+                if (settled)
+                    return;
+                pending -= 1;
+                if (pending === 0 && !settled) {
+                    settled = true;
+                    resolve(null);
+                }
+            });
+        }
+    });
+    if (result)
+        return result;
+    return { provider: null, region: null, source: "none" };
+}
+// ---------------------------------------------------------------------------
+// Orchestration
+// ---------------------------------------------------------------------------
+/** Run Phase 1a + 1b synchronously. Used by tests; never calls IMDS. */
+export function detectNow() {
+    const envResult = _detectEnv();
+    if (envResult && envResult.provider !== null && envResult.region !== null) {
+        return envResult;
+    }
+    const dmi = _detectDmi();
+    const merged = envResult ?? dmi;
+    return merged ?? { provider: null, region: null, source: "none" };
+}
+/**
+ * Resolve provider/region without blocking. Idempotent.
+ *
+ * When `trackNetwork` is false, no probe is launched.
+ *
+ * Phase 1a + 1b run synchronously; Phase 2 is fire-and-forget so init()
+ * returns immediately. Tests can await `_backgroundPromise` via the
+ * `_awaitBackgroundForTests` helper.
+ */
+export function startBackgroundDetection(trackNetwork = true) {
+    if (!trackNetwork) {
+        _setResult({ provider: null, region: null, source: "none" });
+        return;
+    }
+    const initial = detectNow();
+    _setResult(initial);
+    if (initial.provider !== null && initial.region !== null) {
+        return;
+    }
+    // Don't launch a second background probe if one is already in flight.
+    if (_backgroundPromise !== null)
+        return;
+    _backgroundPromise = (async () => {
+        try {
+            const env = await _runProbe(initial.provider);
+            if (env.provider !== null) {
+                // Preserve region from env when IMDS only got the provider, and
+                // preserve instanceType from whichever source has it.
+                const region = env.region ? env.region : initial.region;
+                const instanceType = env.instanceType != null ? env.instanceType : initial.instanceType ?? null;
+                _setResult({
+                    provider: env.provider,
+                    region,
+                    source: env.source,
+                    instanceType,
+                });
+            }
+        }
+        catch {
+            // Fail silent — Phase 2 is best-effort.
+        }
+        finally {
+            _backgroundPromise = null;
+        }
+    })();
+}
+/** Test-only helper to await the background Phase 2 probe. */
+export async function _awaitBackgroundForTests() {
+    if (_backgroundPromise) {
+        await _backgroundPromise;
+    }
+}
+// Exposed for tests that need to call probes directly (parity with the
+// Python `cd._probe_gcp()` test pattern).
+export const _probes = {
+    aws: _probeAws,
+    gcp: _probeGcp,
+    azure: _probeAzure,
+    oci: _probeOci,
+    digitalocean: _probeDigitalOcean,
+    alibaba: _probeAlibaba,
+};
+export { _runProbe };
+//# sourceMappingURL=cloud-detect.js.map

package/dist/cloud-detect.js.map

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

package/dist/core/auto-task.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Auto-task creation for auto-instrumented calls without an explicit task.
+ *
+ * Mirrors the Python SDK's `auto_task.py`. When an LLM/HTTP call happens
+ * outside an explicit `track()` task, an auto-task is created so the cost
+ * is never silently lost. Attribution (customerId/projectId/metadata) is
+ * pulled from the ambient `DexcostContext` when available.
+ */
+import type { Task } from "./models.js";
+/** Return true if there is no active explicit task. */
+export declare function needsAutoTask(): boolean;
+/**
+ * Create an auto-task with attribution from the current DexcostContext.
+ *
+ * Reads `customerId`, `projectId`, `metadata`, and `agent` from the
+ * ambient context (set via `setContext`). When `agent` is set in the
+ * context it overrides the provided `taskType`.
+ */
+export declare function createAutoTask(taskType: string): Task;
+//# sourceMappingURL=auto-task.d.ts.map

package/dist/core/auto-task.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-task.d.ts","sourceRoot":"","sources":["../../src/core/auto-task.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAGxC,uDAAuD;AACvD,wBAAgB,aAAa,IAAI,OAAO,CAEvC;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,CAUrD"}

package/dist/core/auto-task.js

@@ -0,0 +1,34 @@
+/**
+ * Auto-task creation for auto-instrumented calls without an explicit task.
+ *
+ * Mirrors the Python SDK's `auto_task.py`. When an LLM/HTTP call happens
+ * outside an explicit `track()` task, an auto-task is created so the cost
+ * is never silently lost. Attribution (customerId/projectId/metadata) is
+ * pulled from the ambient `DexcostContext` when available.
+ */
+import { randomUUID } from "node:crypto";
+import { createTask } from "./models.js";
+import { getCurrentTask, getContext } from "./context.js";
+/** Return true if there is no active explicit task. */
+export function needsAutoTask() {
+    return getCurrentTask() === undefined;
+}
+/**
+ * Create an auto-task with attribution from the current DexcostContext.
+ *
+ * Reads `customerId`, `projectId`, `metadata`, and `agent` from the
+ * ambient context (set via `setContext`). When `agent` is set in the
+ * context it overrides the provided `taskType`.
+ */
+export function createAutoTask(taskType) {
+    const ctx = getContext();
+    const effectiveTaskType = ctx?.agent ? ctx.agent : taskType;
+    return createTask({
+        taskId: randomUUID(),
+        taskType: effectiveTaskType,
+        customerId: ctx?.customerId,
+        projectId: ctx?.projectId,
+        metadata: ctx?.metadata ? { ...ctx.metadata } : {},
+    });
+}
+//# sourceMappingURL=auto-task.js.map

package/dist/core/auto-task.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-task.js","sourceRoot":"","sources":["../../src/core/auto-task.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1D,uDAAuD;AACvD,MAAM,UAAU,aAAa;IAC3B,OAAO,cAAc,EAAE,KAAK,SAAS,CAAC;AACxC,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,QAAgB;IAC7C,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;IACzB,MAAM,iBAAiB,GAAG,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC5D,OAAO,UAAU,CAAC;QAChB,MAAM,EAAE,UAAU,EAAE;QACpB,QAAQ,EAAE,iBAAiB;QAC3B,UAAU,EAAE,GAAG,EAAE,UAAU;QAC3B,SAAS,EAAE,GAAG,EAAE,SAAS;QACzB,QAAQ,EAAE,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE;KACnD,CAAC,CAAC;AACL,CAAC"}