@tangle-network/agent-app 0.60.68 → 0.60.70

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -42,7 +42,7 @@ import {
42
42
  flattenHistory,
43
43
  readSandboxBinaryBytes,
44
44
  statSandboxFileSize
45
- } from "../chunk-7DG6GGRN.js";
45
+ } from "../chunk-GIJZAJ5W.js";
46
46
  import "../chunk-4LBCTFBP.js";
47
47
  import "../chunk-MCYJON3F.js";
48
48
  import "../chunk-LWSJK546.js";
@@ -673,6 +673,304 @@ async function runForegroundSandboxSingleFlight(options) {
673
673
  }
674
674
  }
675
675
 
676
+ // src/sandbox/warm-lease.ts
677
+ var WARM_SLOTS = 151;
678
+ var DAY_BINS = 144;
679
+ var BIN_MS = 10 * 6e4;
680
+ var HOUR_MS = 36e5;
681
+ var DAY_MS = 24 * HOUR_MS;
682
+ var SLOT_HALF_LIFE_MS = 14 * DAY_MS;
683
+ var PING_MARGIN_MS = 2 * 6e4;
684
+ var THRESHOLD_FLOOR = 0.05;
685
+ var THRESHOLD_CEILING = 0.95;
686
+ var DEFAULT_BUDGETED = ["page-open", "member-activity", "predicted", "scheduled"];
687
+ function warmBinOf(at) {
688
+ return Math.floor((at % DAY_MS + DAY_MS) % DAY_MS / BIN_MS);
689
+ }
690
+ function warmWeekdayOf(at) {
691
+ return (new Date(at).getUTCDay() + 6) % 7;
692
+ }
693
+ function utcDay(at) {
694
+ return new Date(at).toISOString().slice(0, 10);
695
+ }
696
+ function decaySlots(slots, from, at) {
697
+ const factor = from > 0 && at > from ? 0.5 ** ((at - from) / SLOT_HALF_LIFE_MS) : 1;
698
+ return Array.from({ length: WARM_SLOTS }, (_, i) => (slots[i] ?? 0) * factor);
699
+ }
700
+ function addColdArrival(slots, slotsAt, at) {
701
+ const next = decaySlots(slots, slotsAt, at);
702
+ next[warmBinOf(at)] = (next[warmBinOf(at)] ?? 0) + 1;
703
+ next[DAY_BINS + warmWeekdayOf(at)] = (next[DAY_BINS + warmWeekdayOf(at)] ?? 0) + 1;
704
+ return next;
705
+ }
706
+ function predictColdArrival(row, at, windowMs) {
707
+ if (row.firstSeenAt <= 0 || row.slots.length !== WARM_SLOTS) return 0;
708
+ const slots = decaySlots(row.slots, row.slotsAt, at);
709
+ const decay = Math.LN2 / SLOT_HALF_LIFE_MS;
710
+ const observedMs = Math.max(DAY_MS, at - row.firstSeenAt);
711
+ const days = (1 - Math.exp(-decay * observedMs)) / decay / DAY_MS;
712
+ const weekdays = slots.slice(DAY_BINS);
713
+ const meanWeekday = weekdays.reduce((sum, v) => sum + v, 0) / 7;
714
+ const bin = (i) => slots[(i % DAY_BINS + DAY_BINS) % DAY_BINS] ?? 0;
715
+ let expected = 0;
716
+ for (let start = at; start < at + windowMs; ) {
717
+ const index = warmBinOf(start);
718
+ const binEnd = start - (start % BIN_MS + BIN_MS) % BIN_MS + BIN_MS;
719
+ const end = Math.min(binEnd, at + windowMs);
720
+ const smoothed = 0.25 * bin(index - 1) + 0.5 * bin(index) + 0.25 * bin(index + 1);
721
+ const weekday = ((weekdays[warmWeekdayOf(start)] ?? 0) + 1) / (meanWeekday + 1);
722
+ expected += smoothed / days * weekday * ((end - start) / BIN_MS);
723
+ start = end;
724
+ }
725
+ return 1 - Math.exp(-expected);
726
+ }
727
+ function errText2(err) {
728
+ return err instanceof Error ? err.message : String(err);
729
+ }
730
+ function createWarmLeases(options) {
731
+ const { store } = options;
732
+ const boxIdleMs = options.boxIdleMs ?? 30 * 6e4;
733
+ const holdMs = options.holdMs ?? 10 * 6e4;
734
+ const burstHoldMs = options.burstHoldMs ?? boxIdleMs;
735
+ const dailyBudgetMs = options.dailyBudgetMs ?? 30 * 6e4;
736
+ const budgeted = new Set(options.budgetedReasons ?? DEFAULT_BUDGETED);
737
+ const initialThreshold = options.initialThreshold ?? 0.25;
738
+ const now = options.now ?? (() => Date.now());
739
+ const newId = options.newId ?? (() => crypto.randomUUID());
740
+ const emit = (event) => {
741
+ try {
742
+ options.onEvent?.(event);
743
+ } catch {
744
+ }
745
+ };
746
+ const spentToday = (row, at) => row && row.day === utcDay(at) ? row.dayWarmMs : 0;
747
+ function chargeOf(row) {
748
+ if (!row.resumed || row.usedAt > 0 || row.warmAt <= 0) return 0;
749
+ const lastActivity = Math.max(row.warmAt, row.pingAt);
750
+ return Math.max(row.holdUntil, lastActivity + boxIdleMs) - row.warmAt;
751
+ }
752
+ async function signal(key, reason) {
753
+ const at = now();
754
+ if (budgeted.has(reason)) {
755
+ const row = await store.read(key);
756
+ if (!row?.leaseId && spentToday(row, at) >= dailyBudgetMs) {
757
+ emit({ type: "warm_declined", key, reason, why: "budget" });
758
+ return { outcome: "declined" };
759
+ }
760
+ }
761
+ const leaseId = newId();
762
+ const live = await store.begin(key, leaseId, reason, at, at + holdMs);
763
+ if (live !== leaseId) return { outcome: "extended" };
764
+ let box;
765
+ try {
766
+ box = await options.warm(key, reason);
767
+ } catch (err) {
768
+ await store.end(key, leaseId, utcDay(at), 0);
769
+ emit({ type: "warm_failed", key, reason, error: errText2(err) });
770
+ return { outcome: "failed" };
771
+ }
772
+ const warmAt = now();
773
+ if (box === "absent") {
774
+ await store.end(key, leaseId, utcDay(at), 0);
775
+ emit({ type: "warm_declined", key, reason, why: "absent" });
776
+ return { outcome: "declined", box };
777
+ }
778
+ await store.markWarm(key, leaseId, warmAt, box === "resumed");
779
+ emit({ type: "warm_started", key, reason, outcome: box, ms: warmAt - at });
780
+ return { outcome: "started", box };
781
+ }
782
+ async function turn(key) {
783
+ const at = now();
784
+ const before = await store.markUsed(key, at, at + burstHoldMs);
785
+ const coldArrival = !before || before.lastTurnAt <= 0 || at - before.lastTurnAt > boxIdleMs;
786
+ const hit = Boolean(
787
+ before?.leaseId && before.usedAt <= 0 && before.resumed && before.warmAt > 0 && before.warmAt <= at
788
+ );
789
+ if (hit && before) {
790
+ emit({ type: "warm_hit", key, reason: before.reason ?? "unknown", leadMs: at - before.startedAt });
791
+ }
792
+ if (coldArrival) {
793
+ const slots = addColdArrival(before?.slots ?? [], before?.slotsAt ?? 0, at);
794
+ await store.writeProfile(key, slots, at, before?.firstSeenAt || at);
795
+ }
796
+ return { hit, coldArrival };
797
+ }
798
+ async function sweep(sweepOptions = {}) {
799
+ const limit = sweepOptions.limit ?? 50;
800
+ const at = now();
801
+ const report = { ended: 0, wasted: 0, pinged: 0, predicted: 0, errors: 0 };
802
+ for (const row of await store.listExpired(at, limit)) {
803
+ if (!row.leaseId) continue;
804
+ const charge = chargeOf(row);
805
+ let threshold;
806
+ if (row.reason === "predicted" && row.resumed) {
807
+ const current = row.threshold > 0 ? row.threshold : initialThreshold;
808
+ threshold = Math.min(THRESHOLD_CEILING, Math.max(THRESHOLD_FLOOR, current * (row.usedAt > 0 ? 0.85 : 1.3)));
809
+ }
810
+ await store.end(row.key, row.leaseId, utcDay(row.warmAt || row.startedAt), charge, threshold);
811
+ report.ended += 1;
812
+ if (charge > 0) {
813
+ report.wasted += 1;
814
+ emit({ type: "warm_wasted", key: row.key, reason: row.reason ?? "unknown", minutes: Math.round(charge / 6e4) });
815
+ }
816
+ }
817
+ if (options.keepAlive && burstHoldMs > boxIdleMs) {
818
+ for (const row of await store.listHeld(at, limit)) {
819
+ const lastActivity = Math.max(row.pingAt, row.lastTurnAt, row.warmAt);
820
+ if (lastActivity + boxIdleMs - PING_MARGIN_MS > at) continue;
821
+ if (row.holdUntil <= lastActivity + boxIdleMs) continue;
822
+ try {
823
+ await options.keepAlive(row.key);
824
+ await store.markPinged(row.key, at);
825
+ report.pinged += 1;
826
+ } catch {
827
+ report.errors += 1;
828
+ }
829
+ }
830
+ }
831
+ for (const row of await store.listPredictable(at, limit)) {
832
+ if (row.leaseId || at - row.predictedAt < HOUR_MS) continue;
833
+ if (row.lastTurnAt > 0 && at - row.lastTurnAt < boxIdleMs) continue;
834
+ const threshold = row.threshold > 0 ? row.threshold : initialThreshold;
835
+ if (predictColdArrival(row, at, holdMs) < threshold) continue;
836
+ await store.markPredicted(row.key, at);
837
+ try {
838
+ const result = await signal(row.key, "predicted");
839
+ if (result.outcome === "started") report.predicted += 1;
840
+ if (result.outcome === "failed") report.errors += 1;
841
+ } catch {
842
+ report.errors += 1;
843
+ }
844
+ }
845
+ return report;
846
+ }
847
+ return { signal, turn, sweep };
848
+ }
849
+
850
+ // src/sandbox/warm-lease-d1.ts
851
+ var DEFAULT_WARM_LEASE_TABLE = "sandbox_warm_lease";
852
+ var WARM_LEASE_TABLE_DDL = `CREATE TABLE IF NOT EXISTS ${DEFAULT_WARM_LEASE_TABLE} (
853
+ key TEXT PRIMARY KEY,
854
+ lease_id TEXT,
855
+ reason TEXT,
856
+ started_at INTEGER NOT NULL DEFAULT 0,
857
+ hold_until INTEGER NOT NULL DEFAULT 0,
858
+ warm_at INTEGER NOT NULL DEFAULT 0,
859
+ used_at INTEGER NOT NULL DEFAULT 0,
860
+ resumed INTEGER NOT NULL DEFAULT 0,
861
+ ping_at INTEGER NOT NULL DEFAULT 0,
862
+ last_turn_at INTEGER NOT NULL DEFAULT 0,
863
+ day TEXT NOT NULL DEFAULT '',
864
+ day_warm_ms INTEGER NOT NULL DEFAULT 0,
865
+ threshold REAL NOT NULL DEFAULT 0,
866
+ slots TEXT NOT NULL DEFAULT '',
867
+ slots_at INTEGER NOT NULL DEFAULT 0,
868
+ first_seen_at INTEGER NOT NULL DEFAULT 0,
869
+ predicted_at INTEGER NOT NULL DEFAULT 0
870
+ )`;
871
+ var SAFE_IDENTIFIER2 = /^[A-Za-z_][A-Za-z0-9_]*$/;
872
+ function parseSlots(text) {
873
+ if (!text) return [];
874
+ try {
875
+ const parsed = JSON.parse(text);
876
+ if (Array.isArray(parsed) && parsed.length === WARM_SLOTS) return parsed.map((v) => Number(v) || 0);
877
+ } catch {
878
+ }
879
+ return [];
880
+ }
881
+ function toRow(row) {
882
+ return {
883
+ key: row.key,
884
+ leaseId: row.lease_id,
885
+ reason: row.reason,
886
+ startedAt: row.started_at,
887
+ holdUntil: row.hold_until,
888
+ warmAt: row.warm_at,
889
+ usedAt: row.used_at,
890
+ resumed: row.resumed === 1,
891
+ pingAt: row.ping_at,
892
+ lastTurnAt: row.last_turn_at,
893
+ day: row.day,
894
+ dayWarmMs: row.day_warm_ms,
895
+ threshold: row.threshold,
896
+ slots: parseSlots(row.slots),
897
+ slotsAt: row.slots_at,
898
+ firstSeenAt: row.first_seen_at,
899
+ predictedAt: row.predicted_at
900
+ };
901
+ }
902
+ function createD1WarmLeaseStore(db, options = {}) {
903
+ const t = options.table ?? DEFAULT_WARM_LEASE_TABLE;
904
+ if (!SAFE_IDENTIFIER2.test(t)) throw new Error(`Invalid warm lease table name: ${JSON.stringify(t)}`);
905
+ const beginSql = `INSERT INTO ${t} (key, lease_id, reason, started_at, hold_until) VALUES (?1, ?2, ?3, ?4, ?5)
906
+ ON CONFLICT(key) DO UPDATE SET
907
+ lease_id = COALESCE(${t}.lease_id, ?2),
908
+ reason = CASE WHEN ${t}.lease_id IS NULL THEN ?3 ELSE ${t}.reason END,
909
+ started_at = CASE WHEN ${t}.lease_id IS NULL THEN ?4 ELSE ${t}.started_at END,
910
+ warm_at = CASE WHEN ${t}.lease_id IS NULL THEN 0 ELSE ${t}.warm_at END,
911
+ used_at = CASE WHEN ${t}.lease_id IS NULL THEN 0 ELSE ${t}.used_at END,
912
+ resumed = CASE WHEN ${t}.lease_id IS NULL THEN 0 ELSE ${t}.resumed END,
913
+ ping_at = CASE WHEN ${t}.lease_id IS NULL THEN 0 ELSE ${t}.ping_at END,
914
+ hold_until = MAX(${t}.hold_until, ?5)
915
+ RETURNING lease_id`;
916
+ const markWarmSql = `UPDATE ${t} SET warm_at = ?3, resumed = ?4 WHERE key = ?1 AND lease_id = ?2`;
917
+ const firstUseSql = `UPDATE ${t} SET used_at = ?2 WHERE key = ?1 AND lease_id IS NOT NULL AND used_at = 0 RETURNING key`;
918
+ const turnSql = `INSERT INTO ${t} (key, last_turn_at, hold_until) VALUES (?1, ?2, ?3)
919
+ ON CONFLICT(key) DO UPDATE SET last_turn_at = ?2, hold_until = MAX(${t}.hold_until, ?3)`;
920
+ const endSql = `UPDATE ${t} SET
921
+ lease_id = NULL, reason = NULL, started_at = 0, warm_at = 0, used_at = 0, resumed = 0, ping_at = 0,
922
+ day_warm_ms = CASE WHEN day = ?3 THEN day_warm_ms + ?4 WHEN day < ?3 THEN ?4 ELSE day_warm_ms END,
923
+ day = CASE WHEN day < ?3 THEN ?3 ELSE day END,
924
+ threshold = COALESCE(?5, threshold)
925
+ WHERE key = ?1 AND lease_id = ?2`;
926
+ const profileSql = `UPDATE ${t} SET slots = ?2, slots_at = ?3, first_seen_at = ?4 WHERE key = ?1`;
927
+ const readSql = `SELECT * FROM ${t} WHERE key = ?1`;
928
+ const read = async (key) => {
929
+ const row = await db.prepare(readSql).bind(key).first();
930
+ return row ? toRow(row) : null;
931
+ };
932
+ const list = async (sql, ...values) => ((await db.prepare(sql).bind(...values).all()).results ?? []).map(toRow);
933
+ return {
934
+ read,
935
+ async begin(key, leaseId, reason, now, holdUntil) {
936
+ const row = await db.prepare(beginSql).bind(key, leaseId, reason, now, holdUntil).first();
937
+ if (!row) throw new Error("warm lease begin returned no row");
938
+ return row.lease_id;
939
+ },
940
+ async markWarm(key, leaseId, warmAt, resumed) {
941
+ await db.prepare(markWarmSql).bind(key, leaseId, warmAt, resumed ? 1 : 0).run();
942
+ },
943
+ async markUsed(key, now, holdUntil) {
944
+ const before = await read(key);
945
+ const claimed = await db.prepare(firstUseSql).bind(key, now).first();
946
+ await db.prepare(turnSql).bind(key, now, holdUntil).run();
947
+ if (before && !claimed && before.usedAt <= 0) return { ...before, usedAt: now };
948
+ return before;
949
+ },
950
+ async end(key, leaseId, day, chargeMs, threshold) {
951
+ await db.prepare(endSql).bind(key, leaseId, day, Math.max(0, Math.round(chargeMs)), threshold ?? null).run();
952
+ },
953
+ async writeProfile(key, slots, slotsAt, firstSeenAt) {
954
+ const rounded = slots.map((v) => Math.round(v * 1e3) / 1e3);
955
+ await db.prepare(profileSql).bind(key, JSON.stringify(rounded), slotsAt, firstSeenAt).run();
956
+ },
957
+ async markPinged(key, at) {
958
+ await db.prepare(`UPDATE ${t} SET ping_at = ?2 WHERE key = ?1`).bind(key, at).run();
959
+ },
960
+ async markPredicted(key, at) {
961
+ await db.prepare(`UPDATE ${t} SET predicted_at = ?2 WHERE key = ?1`).bind(key, at).run();
962
+ },
963
+ listExpired: (now, limit) => list(`SELECT * FROM ${t} WHERE lease_id IS NOT NULL AND hold_until <= ?1 ORDER BY hold_until LIMIT ?2`, now, limit),
964
+ listHeld: (now, limit) => list(`SELECT * FROM ${t} WHERE hold_until > ?1 ORDER BY ping_at LIMIT ?2`, now, limit),
965
+ // Random order so a large fleet is covered across sweeps instead of always checking the same rows.
966
+ listPredictable: (now, limit) => list(
967
+ `SELECT * FROM ${t} WHERE lease_id IS NULL AND first_seen_at > 0 AND predicted_at <= ?1 ORDER BY random() LIMIT ?2`,
968
+ now - 36e5,
969
+ limit
970
+ )
971
+ };
972
+ }
973
+
676
974
  // src/sandbox/index.ts
677
975
  var DEFAULT_SANDBOX_DIRECT_KEY_NAMES = [
678
976
  "TCLOUD_SANDBOX_API_KEY",
@@ -2548,6 +2846,17 @@ export {
2548
2846
  SandboxProvisioningFailedElsewhereError,
2549
2847
  SandboxFilesystemNotReadyError,
2550
2848
  runForegroundSandboxSingleFlight,
2849
+ WARM_SLOTS,
2850
+ warmBinOf,
2851
+ warmWeekdayOf,
2852
+ utcDay,
2853
+ decaySlots,
2854
+ addColdArrival,
2855
+ predictColdArrival,
2856
+ createWarmLeases,
2857
+ DEFAULT_WARM_LEASE_TABLE,
2858
+ WARM_LEASE_TABLE_DDL,
2859
+ createD1WarmLeaseStore,
2551
2860
  resolveSandboxClientCredentials,
2552
2861
  PYPI_EGRESS_DOMAINS,
2553
2862
  buildProductEgressPolicy,
@@ -2601,4 +2910,4 @@ export {
2601
2910
  isTerminalPromptEvent,
2602
2911
  detectInteractiveQuestion
2603
2912
  };
2604
- //# sourceMappingURL=chunk-7DG6GGRN.js.map
2913
+ //# sourceMappingURL=chunk-GIJZAJ5W.js.map