stitchkit 0.118.1 → 0.120.0

package/dist/entrypoints/tracking.js

@@ -1,8 +1,9 @@
 import {
-  sendUnloadBeacon2,
   redactTrackingText2,
-  redactTrackingValue2
-} from "../index-vv1sch8a.js";
+  maskTrackingParameters,
+  redactTrackingValue2,
+  sendUnloadBeacon2
+} from "../index-8vzh5wpv.js";
 import {
   ApiError2
 } from "../index-kfjkb396.js";
@@ -27,49 +28,55 @@ function isStoredTouch(value) {
   if (!isRecord(value) || !Number.isFinite(value.capturedAt))
     return false;
   const { data } = value;
-  return isRecord(data) && isUtm(data.utm) && isOptionalText(data.referrer) && isOptionalText(data.landingPage);
+  return isRecord(data) && isUtm(data.utm) && (data.clickId === undefined || typeof data.clickId === "string" && data.clickId.length > 0 && data.clickId.length <= MAX_UTM_LENGTH) && isOptionalText(data.referrer) && isOptionalText(data.landingPage);
 }
 function isStoredAttribution(value) {
-  return isRecord(value) && isStoredTouch(value.firstTouch) && isStoredTouch(value.currentTouch);
+  return isRecord(value) && value.version === 1 && isStoredTouch(value.firstTouch);
 }
-function normalize(value) {
+function campaignValue(value) {
   if (!value)
     return;
-  return value.toLowerCase().trim().slice(0, 200) || undefined;
+  return redactTrackingText2(value).slice(0, MAX_UTM_LENGTH);
 }
 function parseUtmFromSearch(search) {
   const params = new URLSearchParams(search);
-  const source = normalize(params.get("utm_source"));
-  if (!source)
-    return null;
-  return {
+  const source = campaignValue(params.get("utm_source"));
+  const utm = {
     source,
-    medium: normalize(params.get("utm_medium")),
-    campaign: normalize(params.get("utm_campaign")),
-    content: normalize(params.get("utm_content")),
-    term: normalize(params.get("utm_term"))
+    medium: campaignValue(params.get("utm_medium")),
+    campaign: campaignValue(params.get("utm_campaign")),
+    content: campaignValue(params.get("utm_content")),
+    term: campaignValue(params.get("utm_term"))
   };
+  return Object.values(utm).some((value) => value !== undefined) ? utm : null;
 }
-function parseReferrer(referrer, currentHostname, referrerMap = []) {
-  if (!referrer)
-    return null;
-  try {
-    const hostname = new URL(referrer).hostname.toLowerCase();
-    if (hostname === currentHostname.toLowerCase())
-      return null;
-    const match = referrerMap.find((rule) => rule.pattern.test(hostname));
-    return match ? { source: match.source, medium: match.medium } : { source: hostname, medium: "referral" };
-  } catch {
-    return null;
+function assertClickIdParams(names) {
+  for (const name of names) {
+    if (typeof name !== "string" || name.length === 0 || name.length > MAX_UTM_LENGTH) {
+      throw new TypeError("clickIdParams names must contain 1–200 characters");
+    }
   }
 }
+function trackedReferrer(referrer, clickIdParams) {
+  return maskTrackingParameters(redactTrackingText2(referrer), new Set(clickIdParams));
+}
+function clickIdFromSearch(search, names) {
+  const params = new URLSearchParams(search);
+  return names.find((name) => params.getAll(name).some((value) => value.length > 0));
+}
+function isFresh(capturedAt, now, ttlMs) {
+  const age = now - capturedAt;
+  return age >= 0 && age <= ttlMs;
+}
 function readStored(storage, key, now, ttlMs) {
+  if (!storage)
+    return null;
   try {
     const raw = storage.getItem(key);
     if (!raw)
       return null;
     const parsed = JSON.parse(raw);
-    if (!isStoredAttribution(parsed) || now - parsed.firstTouch.capturedAt > ttlMs) {
+    if (!isStoredAttribution(parsed) || !isFresh(parsed.firstTouch.capturedAt, now, ttlMs)) {
       storage.removeItem(key);
       return null;
     }
@@ -79,6 +86,8 @@ function readStored(storage, key, now, ttlMs) {
   }
 }
 function writeStored(storage, key, value) {
+  if (!storage)
+    return;
   try {
     storage.setItem(key, JSON.stringify(value));
   } catch {}
@@ -87,47 +96,27 @@ function resolveAttribution({
   search,
   referrer,
   pathname,
-  hostname,
   storage,
-  referrerMap = [],
+  clickIdParams = [],
   storageKey = "tracking.attribution",
   ttlMs = 90 * 24 * 60 * 60 * 1000,
   now = Date.now()
 }) {
+  assertClickIdParams(clickIdParams);
   const stored = readStored(storage, storageKey, now, ttlMs);
-  const urlUtm = parseUtmFromSearch(search);
-  if (urlUtm) {
-    const currentTouch = {
-      utm: urlUtm,
-      referrer: referrer || undefined,
-      landingPage: pathname
-    };
-    const persisted = {
-      firstTouch: {
-        data: stored?.firstTouch.data ?? currentTouch,
-        capturedAt: stored?.firstTouch.capturedAt ?? now
-      },
-      currentTouch: { data: currentTouch, capturedAt: now }
-    };
-    writeStored(storage, storageKey, persisted);
-    return {
-      firstTouch: persisted.firstTouch.data,
-      currentTouch: persisted.currentTouch.data
-    };
-  }
-  if (stored)
-    return { firstTouch: stored.firstTouch.data, currentTouch: stored.currentTouch.data };
-  const fromReferrer = parseReferrer(referrer, hostname, referrerMap);
-  const firstTouch = {
-    utm: fromReferrer ? { source: fromReferrer.source, medium: fromReferrer.medium } : undefined,
-    referrer: referrer || undefined,
-    landingPage: pathname
+  const currentTouch = {
+    utm: parseUtmFromSearch(search) ?? undefined,
+    clickId: clickIdFromSearch(search, clickIdParams),
+    referrer: referrer ? trackedReferrer(referrer, clickIdParams) : undefined,
+    landingPage: redactTrackingText2(pathname)
   };
+  if (stored)
+    return { firstTouch: stored.firstTouch.data, currentTouch };
   writeStored(storage, storageKey, {
-    firstTouch: { data: firstTouch, capturedAt: now },
-    currentTouch: { data: firstTouch, capturedAt: now }
+    version: 1,
+    firstTouch: { data: currentTouch, capturedAt: now }
   });
-  return { firstTouch, currentTouch: firstTouch };
+  return { firstTouch: currentTouch, currentTouch };
 }
 // src/tracking/clicks.ts
 function label(target) {
@@ -359,9 +348,10 @@ function bootstrapTrackingVisit(deps, renew) {
         browserStreamId: visit.browserStreamId,
         previousVisitId: visit.visitId ?? undefined,
         origin: page.origin,
-        landingPath: redactTrackingText2(page.pathname),
-        referrer: page.referrer ? redactTrackingText2(page.referrer) : undefined,
-        utm: touch?.currentTouch.utm?.source ? redactedUtm(touch.currentTouch.utm) : undefined,
+        landingPath: touch.currentTouch.landingPage,
+        referrer: touch.currentTouch.referrer,
+        utm: touch.currentTouch.utm,
+        clickId: touch.currentTouch.clickId,
         displayMode: page.displayMode,
         screenWidth: page.screenWidth,
         screenHeight: page.screenHeight,
@@ -431,22 +421,18 @@ function createVisitSequences(outbox, visit, options, fail) {
     } : undefined
   });
 }
-function redactedUtm(utm) {
-  return Object.fromEntries(Object.entries(utm).map(([field, value]) => [field, redactTrackingText2(value)]));
-}
-function pageAttribution(host, storage, referrerMap, search, pathname) {
+function pageAttribution(host, clickIdParams, search, pathname) {
   const page = host.page();
   return resolveAttribution({
     search,
     pathname,
-    referrer: redactTrackingText2(page.referrer),
-    hostname: page.hostname,
-    storage,
-    referrerMap,
+    referrer: page.referrer,
+    storage: host.storage,
+    clickIdParams,
     now: host.wallClock()
   });
 }
-function pageViewDraft(host, type, pathname, previous) {
+function pageViewDraft(host, type, pathname, previous, clickIdParams) {
   const page = host.page();
   return {
     type,
@@ -455,7 +441,7 @@ function pageViewDraft(host, type, pathname, previous) {
       title: page.title,
       screenWidth: page.viewportWidth,
       screenHeight: page.viewportHeight,
-      referrer: previous || !page.referrer ? undefined : redactTrackingText2(page.referrer)
+      referrer: previous || !page.referrer ? undefined : trackedReferrer(page.referrer, clickIdParams ?? [])
     },
     clientTimestamp: host.wallClock()
   };
@@ -567,9 +553,6 @@ function chunk(items, size) {
 function unloadBeacon(unloadUrl) {
   return (request) => unloadUrl === undefined ? false : sendUnloadBeacon2(unloadUrl, JSON.stringify(request));
 }
-function currentUtmOf(attribution) {
-  return attribution?.currentTouch.utm?.source ? redactedUtm(attribution.currentTouch.utm) : undefined;
-}
 function trackingTimings(config) {
   if (typeof config.buildId !== "string" || config.buildId.length === 0) {
     throw new Error('[stitchkit] tracking client requires a buildId — a git SHA or "dev"');
@@ -584,6 +567,7 @@ function trackingTimings(config) {
 function createTrackingClient(config) {
   const { host, builtin, outbox } = config;
   const { heartbeatMs, renewAfterHiddenMs, pendingLimit, batchSize } = trackingTimings(config);
+  assertClickIdParams(config.clickIdParams ?? []);
   const fail = config.onFailure ?? (() => {
     return;
   });
@@ -604,13 +588,11 @@ function createTrackingClient(config) {
   const scroll = createScrollMilestones(config.scrollMilestones);
   const sequences = createVisitSequences(outbox, visit, config.sequence, fail);
   const captureAttribution = (search, pathname) => {
-    if (!host.storage)
-      return null;
-    attribution = pageAttribution(host, host.storage, config.referrerMap, search, pathname);
+    attribution = pageAttribution(host, config.clickIdParams, search, pathname);
     return attribution;
   };
   const bootstrapVisit = (renew = false) => bootstrapTrackingVisit({ visit, config, host, outbox, sequences, captureAttribution, fail }, renew);
-  const deliver = (events) => deliverTrackedEvents(config, { buildId: config.buildId, events, utm: currentUtmOf(attribution) }, fail);
+  const deliver = (events) => deliverTrackedEvents(config, { buildId: config.buildId, events }, fail);
   const flushOutbox = createOutboxFlusher({
     outbox,
     isAvailable: () => visit.outboxAvailable,
@@ -672,7 +654,7 @@ function createTrackingClient(config) {
       send([draft]);
       return;
     }
-    unload({ buildId: config.buildId, events: [event], utm: currentUtmOf(attribution) });
+    unload({ buildId: config.buildId, events: [event] });
     if (outbox && visit.outboxAvailable)
       outbox.enqueue(event).catch((error) => fail("unload event persistence", error));
   };
@@ -695,7 +677,7 @@ function createTrackingClient(config) {
     currentPage = pathname;
     meter.checkpoint();
     scroll.reset();
-    send([pageViewDraft(host, builtin.pageView, pathname, previous)]);
+    send([pageViewDraft(host, builtin.pageView, pathname, previous, config.clickIdParams)]);
   };
   const start = () => {
     const generation = ++running;
@@ -754,7 +736,6 @@ function browserTrackingHost() {
       pathname: window.location.pathname,
       search: window.location.search,
       origin: window.location.origin,
-      hostname: window.location.hostname,
       title: document.title,
       referrer: document.referrer,
       viewportWidth: window.innerWidth,
@@ -1032,7 +1013,6 @@ export {
   deliverTrackingBatch,
   indexedDbOutboxStorage,
   memoryOutboxStorage,
-  parseReferrer,
   parseUtmFromSearch,
   redactTrackingText2 as redactTrackingText,
   redactTrackingValue2 as redactTrackingValue,

package/dist/entrypoints/xlsx.js

@@ -1,7 +1,7 @@
 import {
   DecimalInputSchema2,
   moneyToDecimal2
-} from "../index-qezhmp51.js";
+} from "../index-nz06qw5a.js";
 
 // src/xlsx/cells.ts
 import { z } from "zod";

package/dist/geo/index.d.ts

@@ -1,4 +1,5 @@
 export { createMaxMindGeoIpLoader } from './maxmind.js';
-export { createGeoIpResolver, mapGeoIpRecord } from './resolver.js';
+export { mapGeoIpRecord } from './record.js';
+export { createGeoIpResolver } from './resolver.js';
 export type { GeoAttribution, GeoIpReader, GeoIpReaderLoader, GeoIpResolver, GeoIpResolverOptions, GeoIpSnapshot, MaxMindGeoIpLoaderOptions, MaxMindGeoIpPaths, } from './types.js';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/geo/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACjE,YAAY,EACV,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,oBAAoB,EACpB,aAAa,EACb,yBAAyB,EACzB,iBAAiB,GAClB,MAAM,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/geo/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AACrD,OAAO,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACjD,YAAY,EACV,cAAc,EACd,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,oBAAoB,EACpB,aAAa,EACb,yBAAyB,EACzB,iBAAiB,GAClB,MAAM,SAAS,CAAC"}

package/dist/geo/record.d.ts

@@ -0,0 +1,8 @@
+import { type GeoAttribution } from './schema.js';
+/**
+ * Map a City + ASN record to the complete sparse snapshot without exposing
+ * optional-peer types. Each field is validated by the schema on its own, so a
+ * malformed value drops that field and keeps the rest.
+ */
+export declare function mapGeoIpRecord(value: unknown): GeoAttribution | null;
+//# sourceMappingURL=record.d.ts.map

package/dist/geo/record.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"record.d.ts","sourceRoot":"","sources":["../../src/geo/record.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,cAAc,EAAuC,MAAM,UAAU,CAAC;AAkCpF;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAsDpE"}

package/dist/geo/resolver.d.ts

@@ -1,6 +1,4 @@
-import type { GeoAttribution, GeoIpResolver, GeoIpResolverOptions } from './types.js';
-/** Map the common MaxMind record shape without exposing peer types. */
-export declare function mapGeoIpRecord(value: unknown): GeoAttribution | null;
+import type { GeoIpResolver, GeoIpResolverOptions } from './types.js';
 /**
  * Create a server-only GeoIP managed resource with atomic generation swaps.
  * Initial absence is non-fatal; reload failure preserves the last good reader.

package/dist/geo/resolver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/geo/resolver.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,cAAc,EAEd,aAAa,EACb,oBAAoB,EAErB,MAAM,SAAS,CAAC;AAwBjB,uEAAuE;AACvE,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,cAAc,GAAG,IAAI,CAyBpE;AAID;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EACxC,OAAO,EAAE,oBAAoB,CAAC,MAAM,CAAC,GACpC,aAAa,CAyHf"}
+{"version":3,"file":"resolver.d.ts","sourceRoot":"","sources":["../../src/geo/resolver.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAe,aAAa,EAAE,oBAAoB,EAAiB,MAAM,SAAS,CAAC;AAc/F;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EACxC,OAAO,EAAE,oBAAoB,CAAC,MAAM,CAAC,GACpC,aAAa,CAyHf"}

package/dist/geo/schema.d.ts

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+/** A label as the GeoIP database spells it; an empty string is no label. */
+export declare const GeoTextSchema: z.ZodString;
+/** GeoNames IDs and the accuracy radius: whole, nonnegative and exact. */
+export declare const GeoNonnegativeIntegerSchema: z.ZodNumber;
+/** One place's names by locale code, every language the database carries. */
+export declare const GeoLocalizedNamesSchema: z.ZodReadonly<z.ZodRecord<z.ZodString, z.ZodString>>;
+/**
+ * Where an IP address is, as a GeoLite2 / GeoIP2 City and ASN record says it.
+ * Every field is optional: a record states what it knows. The located country
+ * and the country the address block is registered to are separate facts.
+ */
+export declare const GeoAttributionSchema: z.ZodReadonly<z.ZodObject<{
+    continentCode: z.ZodOptional<z.ZodString>;
+    continentName: z.ZodOptional<z.ZodString>;
+    continentGeonameId: z.ZodOptional<z.ZodNumber>;
+    countryCode: z.ZodOptional<z.ZodString>;
+    countryName: z.ZodOptional<z.ZodString>;
+    countryGeonameId: z.ZodOptional<z.ZodNumber>;
+    registeredCountryCode: z.ZodOptional<z.ZodString>;
+    registeredCountryName: z.ZodOptional<z.ZodString>;
+    registeredCountryGeonameId: z.ZodOptional<z.ZodNumber>;
+    regionCode: z.ZodOptional<z.ZodString>;
+    regionName: z.ZodOptional<z.ZodString>;
+    regionGeonameId: z.ZodOptional<z.ZodNumber>;
+    city: z.ZodOptional<z.ZodString>;
+    cityGeonameId: z.ZodOptional<z.ZodNumber>;
+    postalCode: z.ZodOptional<z.ZodString>;
+    latitude: z.ZodOptional<z.ZodNumber>;
+    longitude: z.ZodOptional<z.ZodNumber>;
+    timezone: z.ZodOptional<z.ZodString>;
+    accuracyRadiusKm: z.ZodOptional<z.ZodNumber>;
+    autonomousSystemNumber: z.ZodOptional<z.ZodNumber>;
+    autonomousSystemOrganization: z.ZodOptional<z.ZodString>;
+    localizedNames: z.ZodOptional<z.ZodReadonly<z.ZodObject<{
+        continent: z.ZodOptional<z.ZodReadonly<z.ZodRecord<z.ZodString, z.ZodString>>>;
+        country: z.ZodOptional<z.ZodReadonly<z.ZodRecord<z.ZodString, z.ZodString>>>;
+        registeredCountry: z.ZodOptional<z.ZodReadonly<z.ZodRecord<z.ZodString, z.ZodString>>>;
+        region: z.ZodOptional<z.ZodReadonly<z.ZodRecord<z.ZodString, z.ZodString>>>;
+        city: z.ZodOptional<z.ZodReadonly<z.ZodRecord<z.ZodString, z.ZodString>>>;
+    }, z.core.$strict>>>;
+}, z.core.$strict>>;
+export type GeoAttribution = z.infer<typeof GeoAttributionSchema>;
+//# sourceMappingURL=schema.d.ts.map

package/dist/geo/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../src/geo/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,4EAA4E;AAC5E,eAAO,MAAM,aAAa,aAAoB,CAAC;AAC/C,0EAA0E;AAC1E,eAAO,MAAM,2BAA2B,aAAiC,CAAC;AAC1E,6EAA6E;AAC7E,eAAO,MAAM,uBAAuB,sDAAoD,CAAC;AAYzF;;;;GAIG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;mBAyBpB,CAAC;AACd,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC"}

package/dist/geo/types.d.ts

@@ -1,17 +1,6 @@
 import type { ManagedResource, ManagedResourceContext } from '../application/resource.js';
-export interface GeoAttribution {
-    readonly countryCode?: string;
-    readonly countryName?: string;
-    readonly regionCode?: string;
-    readonly regionName?: string;
-    readonly city?: string;
-    readonly postalCode?: string;
-    readonly latitude?: number;
-    readonly longitude?: number;
-    readonly timezone?: string;
-    readonly autonomousSystemNumber?: number;
-    readonly autonomousSystemOrganization?: string;
-}
+import type { GeoAttribution } from './schema.js';
+export type { GeoAttribution } from './schema.js';
 export interface MaxMindGeoIpPaths {
     readonly city: string;
     readonly asn?: string;

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

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/geo/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/geo/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,yBAAyB,CAAC;AACvF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,YAAY,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAE/C,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,yBAAyB;IACxC,sEAAsE;IACtE,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAC;CAC5C;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAChC;AAED,6EAA6E;AAC7E,MAAM,WAAW,iBAAiB,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1E,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAChE,iFAAiF;IACjF,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,MAAM,GAAG,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC;CACnF;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,eAAe,GAAG,aAAa,GAAG,OAAO,CAAC;IAC1D,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,4EAA4E;IAC5E,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,aAAc,SAAQ,eAAe;IACpD,KAAK,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,aAAa,CAAA;KAAE,CAAC,CAAC;IAC1E,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC,CAAC;IACpD,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAC3B,QAAQ,IAAI,aAAa,CAAC;CAC3B;AAED,MAAM,WAAW,oBAAoB,CAAC,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7E,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC,MAAM,CAAC,CAAC;IAC3C,QAAQ,CAAC,MAAM,CAAC,EAAE,KAAK,GAAG;QAAE,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3D,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,MAAM,EAAE,OAAO,KAAK,cAAc,GAAG,IAAI,CAAC;IAC1D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;IAC9B,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC7C"}

package/dist/{index-n5sv4z0w.js → index-0qyrcjfs.js}

@@ -1,16 +1,16 @@
 import {
   NativeCommandError2
-} from "./index-f6m4c545.js";
+} from "./index-zrdcmg6j.js";
 import {
   CommandStopped,
   startNativeCommand
-} from "./index-dr3t5n1v.js";
+} from "./index-nn9qvkww.js";
 import {
   scanContainedFiles
-} from "./index-6f49krb5.js";
+} from "./index-aa50qwv4.js";
 import {
   writeContainedFile
-} from "./index-q968hy6y.js";
+} from "./index-e452syyh.js";
 import {
   listContainedDirectory,
   missingContainedDirectories,
@@ -24,10 +24,10 @@ import {
   containedEntryMetadata,
   openContainedParentFile,
   readContainedUtf8Handle
-} from "./index-arjmb6de.js";
+} from "./index-1jwsfkfz.js";
 import {
   defineRuntimeTool2
-} from "./index-ega3yz4c.js";
+} from "./index-aqwg2dm5.js";
 import {
   errnoOf
 } from "./index-jj9228tt.js";
@@ -252,18 +252,6 @@ async function recordAgentSandboxProbe2(input) {
   return grade;
 }
 
-// src/agent-runtime/coding-tools.ts
-import path4 from "node:path";
-import { z as z5 } from "zod";
-
-// src/agent-runtime/coding-tool-files.ts
-import { createHash } from "node:crypto";
-import { realpath as realpath2 } from "node:fs/promises";
-
-// src/agent-runtime/coding-tool-paths.ts
-import { lstat, realpath } from "node:fs/promises";
-import path from "node:path";
-
 // src/agent-runtime/coding-tool-refusals.ts
 function codingRefusal(code, message, options = {}) {
   throw new AppError2(code, {
@@ -359,7 +347,17 @@ function refuseUnknownSpillReference(reference) {
   });
 }
 
+// src/agent-runtime/coding-tools.ts
+import path4 from "node:path";
+import { z as z5 } from "zod";
+
+// src/agent-runtime/coding-tool-files.ts
+import { createHash } from "node:crypto";
+import { realpath as realpath2 } from "node:fs/promises";
+
 // src/agent-runtime/coding-tool-paths.ts
+import { lstat, realpath } from "node:fs/promises";
+import path from "node:path";
 function within(root, target) {
   const relative = path.relative(root, target);
   return relative === "" || !relative.startsWith(`..${path.sep}`) && relative !== ".." && !path.isAbsolute(relative);

package/dist/index-1psbyyhj.js

@@ -0,0 +1,21 @@
+// src/tools/agent-tool-error.ts
+var AGENT_TOOL_ERROR_BRAND = Symbol.for("stitchkit.AgentToolError");
+
+class AgentToolError2 extends Error {
+  output;
+  constructor(output, cause) {
+    let message = "Tool execution failed";
+    try {
+      message = JSON.stringify(output);
+    } catch {}
+    super(message, cause === undefined ? undefined : { cause });
+    this.name = "AgentToolError";
+    this.output = output;
+    Object.defineProperty(this, AGENT_TOOL_ERROR_BRAND, { value: true });
+  }
+}
+function isAgentToolError2(value) {
+  return typeof value === "object" && value !== null && AGENT_TOOL_ERROR_BRAND in value;
+}
+
+export { AgentToolError2, isAgentToolError2 };