actoviq-agent-sdk 0.2.0 → 0.3.1

package/dist/src/scheduling/cron.js

@@ -0,0 +1,159 @@
+const CRON_FIELD_RANGES = [
+    [0, 59], // minute
+    [0, 23], // hour
+    [1, 31], // day of month
+    [1, 12], // month
+    [0, 7], // day of week (0 and 7 both Sunday)
+];
+const DAY_NAMES = {
+    sun: 0, mon: 1, tue: 2, wed: 3, thu: 4, fri: 5, sat: 6,
+};
+const MONTH_NAMES = {
+    jan: 1, feb: 2, mar: 3, apr: 4, may: 5, jun: 6,
+    jul: 7, aug: 8, sep: 9, oct: 10, nov: 11, dec: 12,
+};
+export function parseCron(expression) {
+    const parts = expression.trim().split(/\s+/);
+    if (parts.length !== 5) {
+        throw new Error(`Cron expression "${expression}" must have exactly 5 fields (minute hour dom month dow), got ${parts.length}`);
+    }
+    return parts.map((field, i) => parseCronField(field, ...CRON_FIELD_RANGES[i]));
+}
+function parseCronField(field, min, max) {
+    const normalized = field.toLowerCase();
+    if (normalized === '*') {
+        return { allowed: () => true, min, max };
+    }
+    const values = new Set();
+    const segments = normalized.split(',');
+    for (const segment of segments) {
+        const stepMatch = segment.match(/^(.+?)\/(\d+)$/);
+        let baseRange = segment;
+        let step = 1;
+        if (stepMatch) {
+            baseRange = stepMatch[1];
+            step = parseInt(stepMatch[2], 10);
+            if (step < 1)
+                throw new Error(`Invalid step "${step}" in cron field "${field}"`);
+        }
+        if (baseRange === '*') {
+            for (let v = min; v <= max; v += step) {
+                values.add(v);
+            }
+            continue;
+        }
+        const rangeMatch = baseRange.match(/^(.+?)-(.+)$/);
+        let start;
+        let end;
+        if (rangeMatch) {
+            start = resolveName(rangeMatch[1], min, max);
+            end = resolveName(rangeMatch[2], min, max);
+        }
+        else {
+            start = resolveName(baseRange, min, max);
+            end = start;
+        }
+        if (start < min || start > max) {
+            throw new Error(`Value ${start} out of range [${min},${max}] in cron field "${field}"`);
+        }
+        if (end < min || end > max) {
+            throw new Error(`Value ${end} out of range [${min},${max}] in cron field "${field}"`);
+        }
+        for (let v = start; v <= end; v += step) {
+            values.add(v);
+        }
+    }
+    const arr = [...values].sort((a, b) => a - b);
+    return {
+        allowed: (v) => values.has(v),
+        min: arr[0] ?? min,
+        max: arr[arr.length - 1] ?? max,
+    };
+}
+function resolveName(token, min, max) {
+    const n = parseInt(token, 10);
+    if (!isNaN(n))
+        return n;
+    if (max === 6 || max === 7) {
+        const d = DAY_NAMES[token];
+        if (d !== undefined)
+            return d;
+    }
+    if (max === 12) {
+        const m = MONTH_NAMES[token];
+        if (m !== undefined)
+            return m;
+    }
+    throw new Error(`Cannot resolve "${token}" in cron field (range ${min}-${max})`);
+}
+export function nextCronTime(expression, from) {
+    return nextCronTimeImpl(parseCron(expression), from ?? new Date());
+}
+export function nextCronTimeImpl(fields, from) {
+    const MAX_ITERATIONS = 366 * 24 * 60; // 2 years in minutes
+    const current = new Date(from);
+    current.setSeconds(0, 0);
+    current.setMinutes(current.getMinutes() + 1); // Start from next minute
+    const [minField, hourField, domField, monthField, dowField] = fields;
+    for (let i = 0; i < MAX_ITERATIONS; i++) {
+        const minute = current.getMinutes();
+        const hour = current.getHours();
+        const dom = current.getDate();
+        const month = current.getMonth() + 1; // 1-indexed
+        const year = current.getFullYear();
+        if (!minField.allowed(minute)) {
+            current.setMinutes(minute + 1, 0, 0);
+            continue;
+        }
+        if (!hourField.allowed(hour)) {
+            current.setMinutes(0, 0, 0);
+            current.setHours(hour + 1);
+            continue;
+        }
+        const dow = current.getDay(); // 0=Sun
+        const dowMatch = dow === 0
+            ? dowField.allowed(0) || dowField.allowed(7)
+            : dowField.allowed(dow);
+        const domMatch = domField.allowed(dom);
+        // For cron, if both dom and dow are specified (non-*), they OR together.
+        // If only one is specified, it ANDs normally.
+        const domSpecified = !isWildcard(domField, 1, 31);
+        const dowSpecified = !isWildcard(dowField, 0, 7);
+        let dayMatch;
+        if (domSpecified && dowSpecified) {
+            dayMatch = domMatch || dowMatch;
+        }
+        else {
+            dayMatch = domMatch && dowMatch;
+        }
+        if (!dayMatch) {
+            current.setMinutes(0, 0, 0);
+            current.setHours(0);
+            current.setDate(dom + 1);
+            continue;
+        }
+        if (!monthField.allowed(month)) {
+            current.setMinutes(0, 0, 0);
+            current.setHours(0);
+            current.setDate(1);
+            current.setMonth(month); // month is 0-indexed here, so this advances by 1
+            continue;
+        }
+        return new Date(current);
+    }
+    throw new Error(`No matching time found for cron expression within 2 years`);
+}
+function isWildcard(field, min, max) {
+    for (let v = min; v <= max; v++) {
+        if (!field.allowed(v))
+            return false;
+    }
+    return true;
+}
+/**
+ * Returns the number of milliseconds until the next cron fire time.
+ */
+export function msUntilNextCron(expression, from) {
+    return nextCronTime(expression, from).getTime() - (from ?? new Date()).getTime();
+}
+//# sourceMappingURL=cron.js.map

package/dist/src/scheduling/cron.js.map

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

package/dist/src/scheduling/index.d.ts

@@ -0,0 +1,3 @@
+export { parseCron, nextCronTime, msUntilNextCron } from './cron.js';
+export { TaskScheduler, InMemoryTaskStore } from './scheduler.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/scheduling/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/scheduling/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/src/scheduling/index.js

@@ -0,0 +1,3 @@
+export { parseCron, nextCronTime, msUntilNextCron } from './cron.js';
+export { TaskScheduler, InMemoryTaskStore } from './scheduler.js';
+//# sourceMappingURL=index.js.map

package/dist/src/scheduling/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/scheduling/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACrE,OAAO,EAAE,aAAa,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/src/scheduling/scheduler.d.ts

@@ -0,0 +1,32 @@
+import type { ScheduledTaskDefinition, ScheduledTaskRecord, ScheduledTaskStore, TaskSchedulerOptions } from '../types.js';
+export declare class InMemoryTaskStore implements ScheduledTaskStore {
+    private readonly tasks;
+    save(task: ScheduledTaskRecord): Promise<void>;
+    load(id: string): Promise<ScheduledTaskRecord | undefined>;
+    list(): Promise<ScheduledTaskRecord[]>;
+    delete(id: string): Promise<void>;
+}
+export declare class TaskScheduler {
+    private readonly store;
+    private readonly definitions;
+    private readonly defaultTimeoutMs;
+    private readonly defaultMaxRetries;
+    private readonly defaultRetryDelayMs;
+    private timer?;
+    private running;
+    private disposed;
+    constructor(options?: TaskSchedulerOptions);
+    schedule<TOutput>(def: ScheduledTaskDefinition<TOutput>): Promise<ScheduledTaskRecord>;
+    remove(id: string): Promise<void>;
+    get(id: string): Promise<ScheduledTaskRecord | undefined>;
+    list(): Promise<ScheduledTaskRecord[]>;
+    start(): void;
+    stop(): void;
+    dispose(): Promise<void>;
+    get isRunning(): boolean;
+    /** Force immediate execution of a task (bypasses schedule). Useful for testing and manual triggers. */
+    trigger(id: string): Promise<void>;
+    private scheduleNextTick;
+    private fire;
+}
+//# sourceMappingURL=scheduler.d.ts.map

package/dist/src/scheduling/scheduler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../../../src/scheduling/scheduler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAGV,uBAAuB,EACvB,mBAAmB,EACnB,kBAAkB,EAClB,oBAAoB,EACrB,MAAM,aAAa,CAAC;AAIrB,qBAAa,iBAAkB,YAAW,kBAAkB;IAC1D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0C;IAE1D,IAAI,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9C,IAAI,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC;IAK1D,IAAI,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAItC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGxC;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAqB;IAC3C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAGxB;IACJ,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAS;IAC1C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAS;IAC7C,OAAO,CAAC,KAAK,CAAC,CAAgC;IAC9C,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,GAAE,oBAAyB;IASxC,QAAQ,CAAC,OAAO,EACpB,GAAG,EAAE,uBAAuB,CAAC,OAAO,CAAC,GACpC,OAAO,CAAC,mBAAmB,CAAC;IA8BzB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKjC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,GAAG,SAAS,CAAC;IAIzD,IAAI,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAM5C,KAAK,IAAI,IAAI;IAOb,IAAI,IAAI,IAAI;IAQN,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAM9B,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,uGAAuG;IACjG,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQxC,OAAO,CAAC,gBAAgB;YAwBV,IAAI;CA2DnB"}

package/dist/src/scheduling/scheduler.js

@@ -0,0 +1,196 @@
+import { nowIso } from '../runtime/helpers.js';
+import { nextCronTime } from './cron.js';
+export class InMemoryTaskStore {
+    tasks = new Map();
+    async save(task) {
+        this.tasks.set(task.id, { ...task });
+    }
+    async load(id) {
+        const t = this.tasks.get(id);
+        return t ? { ...t } : undefined;
+    }
+    async list() {
+        return [...this.tasks.values()].map((t) => ({ ...t }));
+    }
+    async delete(id) {
+        this.tasks.delete(id);
+    }
+}
+export class TaskScheduler {
+    store;
+    definitions = new Map();
+    defaultTimeoutMs;
+    defaultMaxRetries;
+    defaultRetryDelayMs;
+    timer;
+    running = false;
+    disposed = false;
+    constructor(options = {}) {
+        this.store = options.store ?? new InMemoryTaskStore();
+        this.defaultTimeoutMs = options.defaultTimeoutMs ?? 60_000;
+        this.defaultMaxRetries = options.defaultMaxRetries ?? 0;
+        this.defaultRetryDelayMs = options.defaultRetryDelayMs ?? 1000;
+    }
+    // ── Registration ────────────────────────────────────────────
+    async schedule(def) {
+        if (this.disposed)
+            throw new Error('Scheduler is disposed');
+        const now = nowIso();
+        const invocationCount = 0;
+        const nextRunAt = nextCronTime(def.schedule.cron).toISOString();
+        const record = {
+            id: def.id,
+            schedule: def.schedule.cron,
+            description: def.description,
+            enabled: def.enabled ?? true,
+            nextRunAt,
+            invocationCount,
+            createdAt: now,
+        };
+        await this.store.save(record);
+        this.definitions.set(def.id, {
+            ...def,
+            enabled: def.enabled ?? true,
+            nextRunAt,
+            invocationCount,
+            createdAt: now,
+        });
+        return record;
+    }
+    async remove(id) {
+        this.definitions.delete(id);
+        await this.store.delete(id);
+    }
+    async get(id) {
+        return this.store.load(id);
+    }
+    async list() {
+        return this.store.list();
+    }
+    // ── Lifecycle ───────────────────────────────────────────────
+    start() {
+        if (this.disposed)
+            throw new Error('Scheduler is disposed');
+        if (this.running)
+            return;
+        this.running = true;
+        this.scheduleNextTick();
+    }
+    stop() {
+        this.running = false;
+        if (this.timer) {
+            clearTimeout(this.timer);
+            this.timer = undefined;
+        }
+    }
+    async dispose() {
+        this.stop();
+        this.disposed = true;
+        this.definitions.clear();
+    }
+    get isRunning() {
+        return this.running;
+    }
+    /** Force immediate execution of a task (bypasses schedule). Useful for testing and manual triggers. */
+    async trigger(id) {
+        const def = this.definitions.get(id);
+        if (!def)
+            throw new Error(`Task "${id}" not found`);
+        await this.fire(id, def);
+    }
+    // ── Internal tick ───────────────────────────────────────────
+    scheduleNextTick() {
+        if (!this.running || this.disposed)
+            return;
+        const now = Date.now();
+        let earliestMs = 60_000; // Default tick if nothing sooner
+        for (const [id, def] of this.definitions) {
+            if (!def.enabled)
+                continue;
+            const nextMs = new Date(def.nextRunAt).getTime();
+            if (nextMs <= now) {
+                // Due now — fire asynchronously
+                this.fire(id, def);
+            }
+            else {
+                const wait = nextMs - now;
+                if (wait < earliestMs)
+                    earliestMs = wait;
+            }
+        }
+        // Clamp between 500ms and 60s
+        const delay = Math.max(500, Math.min(earliestMs, 60_000));
+        this.timer = setTimeout(() => this.scheduleNextTick(), delay);
+        if (this.timer.unref)
+            this.timer.unref();
+    }
+    async fire(id, def) {
+        if (!def.enabled)
+            return;
+        const startedAt = nowIso();
+        const invocationCount = def.invocationCount + 1;
+        def.invocationCount = invocationCount;
+        const context = {
+            taskId: id,
+            scheduledAt: startedAt,
+            invocationCount,
+            previousResult: undefined,
+        };
+        const timeoutMs = def.timeoutMs ?? this.defaultTimeoutMs;
+        const maxRetries = def.maxRetries ?? this.defaultMaxRetries;
+        const retryDelayMs = def.retryDelayMs ?? this.defaultRetryDelayMs;
+        let lastError;
+        let success = false;
+        for (let attempt = 0; attempt <= maxRetries; attempt++) {
+            try {
+                await withTimeout(Promise.resolve(def.task(context)), timeoutMs);
+                success = true;
+                lastError = undefined;
+                break;
+            }
+            catch (err) {
+                lastError = err instanceof Error ? err.message : String(err);
+                if (attempt < maxRetries) {
+                    await delay(retryDelayMs);
+                }
+            }
+        }
+        const completedAt = nowIso();
+        // Calculate next run time from when the task was scheduled, not completed
+        const nextRunAt = nextCronTime(def.schedule.cron, new Date(startedAt)).toISOString();
+        def.nextRunAt = nextRunAt;
+        const record = {
+            id,
+            schedule: def.schedule.cron,
+            description: def.description,
+            enabled: def.enabled,
+            lastRunAt: completedAt,
+            lastResult: success ? 'success' : lastError?.includes('timed out') ? 'timeout' : 'failure',
+            lastError,
+            nextRunAt,
+            invocationCount,
+            createdAt: def.createdAt ?? nowIso(),
+        };
+        await this.store.save(record);
+        this.definitions.set(id, def);
+    }
+}
+function delay(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+async function withTimeout(promise, ms) {
+    if (ms <= 0 || !isFinite(ms))
+        return promise;
+    let timer;
+    const timeout = new Promise((_, reject) => {
+        timer = setTimeout(() => reject(new Error(`Task timed out after ${ms}ms`)), ms);
+    });
+    try {
+        return await Promise.race([promise, timeout]);
+    }
+    finally {
+        if (timer)
+            clearTimeout(timer);
+    }
+}
+//# sourceMappingURL=scheduler.js.map

package/dist/src/scheduling/scheduler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler.js","sourceRoot":"","sources":["../../../src/scheduling/scheduler.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAEzC,MAAM,OAAO,iBAAiB;IACX,KAAK,GAAG,IAAI,GAAG,EAA+B,CAAC;IAEhE,KAAK,CAAC,IAAI,CAAC,IAAyB;QAClC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAU;QACnB,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QAC7B,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IAClC,CAAC;IAED,KAAK,CAAC,IAAI;QACR,OAAO,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACxB,CAAC;CACF;AAED,MAAM,OAAO,aAAa;IACP,KAAK,CAAqB;IAC1B,WAAW,GAAG,IAAI,GAAG,EAGnC,CAAC;IACa,gBAAgB,CAAS;IACzB,iBAAiB,CAAS;IAC1B,mBAAmB,CAAS;IACrC,KAAK,CAAiC;IACtC,OAAO,GAAG,KAAK,CAAC;IAChB,QAAQ,GAAG,KAAK,CAAC;IAEzB,YAAY,UAAgC,EAAE;QAC5C,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,IAAI,iBAAiB,EAAE,CAAC;QACtD,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,MAAM,CAAC;QAC3D,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,CAAC,CAAC;QACxD,IAAI,CAAC,mBAAmB,GAAG,OAAO,CAAC,mBAAmB,IAAI,IAAI,CAAC;IACjE,CAAC;IAED,+DAA+D;IAE/D,KAAK,CAAC,QAAQ,CACZ,GAAqC;QAErC,IAAI,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAE5D,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC;QACrB,MAAM,eAAe,GAAG,CAAC,CAAC;QAC1B,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC;QAEhE,MAAM,MAAM,GAAwB;YAClC,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,IAAI;YAC3B,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,IAAI;YAC5B,SAAS;YACT,eAAe;YACf,SAAS,EAAE,GAAG;SACf,CAAC;QAEF,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAE9B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,EAAE;YAC3B,GAAG,GAAG;YACN,OAAO,EAAE,GAAG,CAAC,OAAO,IAAI,IAAI;YAC5B,SAAS;YACT,eAAe;YACf,SAAS,EAAE,GAAG;SACf,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,EAAU;QACrB,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QAC5B,MAAM,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,EAAU;QAClB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC;IAED,KAAK,CAAC,IAAI;QACR,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;IAC3B,CAAC;IAED,+DAA+D;IAE/D,KAAK;QACH,IAAI,IAAI,CAAC,QAAQ;YAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC5D,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,CAAC,gBAAgB,EAAE,CAAC;IAC1B,CAAC;IAED,IAAI;QACF,IAAI,CAAC,OAAO,GAAG,KAAK,CAAC;QACrB,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;YACf,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;YACzB,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC;QACzB,CAAC;IACH,CAAC;IAED,KAAK,CAAC,OAAO;QACX,IAAI,CAAC,IAAI,EAAE,CAAC;QACZ,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC;QACrB,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAED,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,uGAAuG;IACvG,KAAK,CAAC,OAAO,CAAC,EAAU;QACtB,MAAM,GAAG,GAAG,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrC,IAAI,CAAC,GAAG;YAAE,MAAM,IAAI,KAAK,CAAC,SAAS,EAAE,aAAa,CAAC,CAAC;QACpD,MAAM,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IAC3B,CAAC;IAED,+DAA+D;IAEvD,gBAAgB;QACtB,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAE3C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,UAAU,GAAG,MAAM,CAAC,CAAC,iCAAiC;QAE1D,KAAK,MAAM,CAAC,EAAE,EAAE,GAAG,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YACzC,IAAI,CAAC,GAAG,CAAC,OAAO;gBAAE,SAAS;YAC3B,MAAM,MAAM,GAAG,IAAI,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,CAAC;YACjD,IAAI,MAAM,IAAI,GAAG,EAAE,CAAC;gBAClB,gCAAgC;gBAChC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;YACrB,CAAC;iBAAM,CAAC;gBACN,MAAM,IAAI,GAAG,MAAM,GAAG,GAAG,CAAC;gBAC1B,IAAI,IAAI,GAAG,UAAU;oBAAE,UAAU,GAAG,IAAI,CAAC;YAC3C,CAAC;QACH,CAAC;QAED,8BAA8B;QAC9B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;QAC1D,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,gBAAgB,EAAE,EAAE,KAAK,CAAC,CAAC;QAC9D,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK;YAAE,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;IAC3C,CAAC;IAEO,KAAK,CAAC,IAAI,CAChB,EAAU,EACV,GAAgG;QAEhG,IAAI,CAAC,GAAG,CAAC,OAAO;YAAE,OAAO;QAEzB,MAAM,SAAS,GAAG,MAAM,EAAE,CAAC;QAC3B,MAAM,eAAe,GAAG,GAAG,CAAC,eAAe,GAAG,CAAC,CAAC;QAChD,GAAG,CAAC,eAAe,GAAG,eAAe,CAAC;QAEtC,MAAM,OAAO,GAAyB;YACpC,MAAM,EAAE,EAAE;YACV,WAAW,EAAE,SAAS;YACtB,eAAe;YACf,cAAc,EAAE,SAAS;SAC1B,CAAC;QAEF,MAAM,SAAS,GAAG,GAAG,CAAC,SAAS,IAAI,IAAI,CAAC,gBAAgB,CAAC;QACzD,MAAM,UAAU,GAAG,GAAG,CAAC,UAAU,IAAI,IAAI,CAAC,iBAAiB,CAAC;QAC5D,MAAM,YAAY,GAAG,GAAG,CAAC,YAAY,IAAI,IAAI,CAAC,mBAAmB,CAAC;QAElE,IAAI,SAA6B,CAAC;QAClC,IAAI,OAAO,GAAG,KAAK,CAAC;QAEpB,KAAK,IAAI,OAAO,GAAG,CAAC,EAAE,OAAO,IAAI,UAAU,EAAE,OAAO,EAAE,EAAE,CAAC;YACvD,IAAI,CAAC;gBACH,MAAM,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;gBACjE,OAAO,GAAG,IAAI,CAAC;gBACf,SAAS,GAAG,SAAS,CAAC;gBACtB,MAAM;YACR,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,SAAS,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAC7D,IAAI,OAAO,GAAG,UAAU,EAAE,CAAC;oBACzB,MAAM,KAAK,CAAC,YAAY,CAAC,CAAC;gBAC5B,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,EAAE,CAAC;QAC7B,0EAA0E;QAC1E,MAAM,SAAS,GAAG,YAAY,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC;QACrF,GAAG,CAAC,SAAS,GAAG,SAAS,CAAC;QAE1B,MAAM,MAAM,GAAwB;YAClC,EAAE;YACF,QAAQ,EAAE,GAAG,CAAC,QAAQ,CAAC,IAAI;YAC3B,WAAW,EAAE,GAAG,CAAC,WAAW;YAC5B,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,SAAS,EAAE,WAAW;YACtB,UAAU,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,EAAE,QAAQ,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS;YAC1F,SAAS;YACT,SAAS;YACT,eAAe;YACf,SAAS,EAAE,GAAG,CAAC,SAAS,IAAI,MAAM,EAAE;SACrC,CAAC;QAEF,MAAM,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QAC9B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IAChC,CAAC;CACF;AAED,SAAS,KAAK,CAAC,EAAU;IACvB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,KAAK,UAAU,WAAW,CAAI,OAAmB,EAAE,EAAU;IAC3D,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QAAE,OAAO,OAAO,CAAC;IAC7C,IAAI,KAAgD,CAAC;IACrD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE;QAC/C,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,wBAAwB,EAAE,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAClF,CAAC,CAAC,CAAC;IACH,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IAChD,CAAC;YAAS,CAAC;QACT,IAAI,KAAK;YAAE,YAAY,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;AACH,CAAC"}

package/dist/src/storage/backgroundTaskStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backgroundTaskStore.d.ts","sourceRoot":"","sources":["../../../src/storage/backgroundTaskStore.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAG/D,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAAb,aAAa,EAAE,MAAM;IAE5C,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,2BAA2B,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAU3F,IAAI,CAAC,IAAI,EAAE,2BAA2B,GAAG,OAAO,CAAC,IAAI,CAAC;IAKtD,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,2BAA2B,GAAG,SAAS,CAAC;IActE,IAAI,IAAI,OAAO,CAAC,2BAA2B,EAAE,CAAC;IAgB9C,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAK7B,WAAW;IAIzB,OAAO,CAAC,cAAc;IAItB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;CAGjC"}
+{"version":3,"file":"backgroundTaskStore.d.ts","sourceRoot":"","sources":["../../../src/storage/backgroundTaskStore.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAI/D,qBAAa,mBAAmB;IAClB,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAAb,aAAa,EAAE,MAAM;IAE5C,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,2BAA2B,EAAE,IAAI,CAAC,GAAG,OAAO,CAAC,2BAA2B,CAAC;IAU3F,IAAI,CAAC,IAAI,EAAE,2BAA2B,GAAG,OAAO,CAAC,IAAI,CAAC;IAKtD,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,2BAA2B,GAAG,SAAS,CAAC;IActE,IAAI,IAAI,OAAO,CAAC,2BAA2B,EAAE,CAAC;IAgB9C,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAK7B,WAAW;IAIzB,OAAO,CAAC,cAAc;IAItB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;CAMjC"}

package/dist/src/storage/backgroundTaskStore.js

@@ -1,6 +1,7 @@
 import { mkdir, readFile, readdir, rename, rm, writeFile } from 'node:fs/promises';
 import path from 'node:path';
 import { createId } from '../runtime/helpers.js';
+import { joinUnderStorageRoot, safeStorageFileName } from './pathSafety.js';
 export class BackgroundTaskStore {
     rootDirectory;
     constructor(rootDirectory) {
@@ -54,10 +55,10 @@ export class BackgroundTaskStore {
         await mkdir(this.tasksDirectory(), { recursive: true });
     }
     tasksDirectory() {
-        return path.join(this.rootDirectory, 'tasks');
+        return joinUnderStorageRoot(this.rootDirectory, 'tasks');
     }
     taskPath(taskId) {
-        return path.join(this.tasksDirectory(), `${taskId}.json`);
+        return joinUnderStorageRoot(this.tasksDirectory(), safeStorageFileName('taskId', taskId, 'json'));
     }
 }
 async function writeJsonAtomic(filePath, data) {

package/dist/src/storage/backgroundTaskStore.js.map

@@ -1 +1 @@
-{"version":3,"file":"backgroundTaskStore.js","sourceRoot":"","sources":["../../../src/storage/backgroundTaskStore.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACnF,OAAO,IAAI,MAAM,WAAW,CAAC;AAG7B,OAAO,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAEjD,MAAM,OAAO,mBAAmB;IACD;IAA7B,YAA6B,aAAqB;QAArB,kBAAa,GAAb,aAAa,CAAQ;IAAG,CAAC;IAEtD,KAAK,CAAC,MAAM,CAAC,IAA6C;QACxD,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,MAAM,GAAgC;YAC1C,GAAG,IAAI;YACP,EAAE,EAAE,QAAQ,EAAE;SACf,CAAC;QACF,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAiC;QAC1C,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;IACtD,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,MAAc;QACvB,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC;YAC1D,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAgC,CAAC;QACxD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,SAAS,GAAG,KAA8B,CAAC;YACjD,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAChC,OAAO,SAAS,CAAC;YACnB,CAAC;YACD,MAAM,KAAK,CAAC;QACd,CAAC;IACH,CAAC;IAED,KAAK,CAAC,IAAI;QACR,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC,CAAC;QACnD,MAAM,KAAK,GAAkC,EAAE,CAAC;QAEhD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;gBAC5B,SAAS;YACX,CAAC;YACD,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;YAC3E,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAgC,CAAC,CAAC;QAC7D,CAAC;QAED,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,SAAS,CAAC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IACpF,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,MAAc;QACzB,MAAM,IAAI,CAAC,WAAW,EAAE,CAAC;QACzB,MAAM,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,CAAC;IAEO,KAAK,CAAC,WAAW;QACvB,MAAM,KAAK,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC1D,CAAC;IAEO,cAAc;QACpB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;IAChD,CAAC;IAED,QAAQ,CAAC,MAAc;QACrB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,EAAE,GAAG,MAAM,OAAO,CAAC,CAAC;IAC5D,CAAC;CACF;AAED,KAAK,UAAU,eAAe,CAAC,QAAgB,EAAE,IAAa;IAC5D,MAAM,QAAQ,GAAG,GAAG,QAAQ,IAAI,QAAQ,EAAE,MAAM,CAAC;IACjD,MAAM,SAAS,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IACxE,MAAM,MAAM,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AACnC,CAAC"}
+{"version":3,"file":"backgroundTaskStore.js","sourceRoot":"","sources":["../../../src/storage/backgroundTaskStore.ts"],"names":[],"mappings":"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"}

package/dist/src/storage/mailboxStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mailboxStore.d.ts","sourceRoot":"","sources":["../../../src/storage/mailboxStore.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAGzD,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAAb,aAAa,EAAE,MAAM;IAE5C,IAAI,CACR,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,IAAI,CAAC,qBAAqB,EAAE,IAAI,GAAG,UAAU,GAAG,IAAI,CAAC,GAC7D,OAAO,CAAC,qBAAqB,CAAC;IAc3B,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAc3E,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAM5E,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAMrD,OAAO,CAAC,aAAa;IAIrB,OAAO,CAAC,WAAW;YAIL,WAAW;CAG1B"}
+{"version":3,"file":"mailboxStore.d.ts","sourceRoot":"","sources":["../../../src/storage/mailboxStore.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,aAAa,CAAC;AAQzD,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAAb,aAAa,EAAE,MAAM;IAE5C,IAAI,CACR,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,IAAI,CAAC,qBAAqB,EAAE,IAAI,GAAG,UAAU,GAAG,IAAI,CAAC,GAC7D,OAAO,CAAC,qBAAqB,CAAC;IAc3B,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAc3E,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAM5E,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAMrD,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,WAAW;YAOL,WAAW;CAG1B"}

package/dist/src/storage/mailboxStore.js

@@ -1,6 +1,6 @@
 import { mkdir, readFile, readdir, rename, rm, writeFile } from 'node:fs/promises';
-import path from 'node:path';
 import { createId } from '../runtime/helpers.js';
+import { assertSafeStorageSegment, joinUnderStorageRoot, safeStorageFileName, } from './pathSafety.js';
 export class MailboxStore {
     rootDirectory;
     constructor(rootDirectory) {
@@ -44,10 +44,10 @@ export class MailboxStore {
         return files.filter(file => file.endsWith('.json')).map(file => file.replace(/\.json$/u, ''));
     }
     teamDirectory(teamName) {
-        return path.join(this.rootDirectory, 'mailboxes', teamName);
+        return joinUnderStorageRoot(this.rootDirectory, 'mailboxes', assertSafeStorageSegment('teamName', teamName));
     }
     mailboxPath(teamName, recipient) {
-        return path.join(this.teamDirectory(teamName), `${recipient}.json`);
+        return joinUnderStorageRoot(this.teamDirectory(teamName), safeStorageFileName('recipient', recipient, 'json'));
     }
     async ensureReady(teamName) {
         await mkdir(this.teamDirectory(teamName), { recursive: true });

package/dist/src/storage/mailboxStore.js.map

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

package/dist/src/storage/pathSafety.d.ts

@@ -0,0 +1,4 @@
+export declare function assertSafeStorageSegment(label: string, value: string): string;
+export declare function safeStorageFileName(label: string, value: string, extension: string): string;
+export declare function joinUnderStorageRoot(rootDirectory: string, ...segments: string[]): string;
+//# sourceMappingURL=pathSafety.d.ts.map

package/dist/src/storage/pathSafety.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathSafety.d.ts","sourceRoot":"","sources":["../../../src/storage/pathSafety.ts"],"names":[],"mappings":"AAMA,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAc7E;AAED,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAG3F;AAED,wBAAgB,oBAAoB,CAAC,aAAa,EAAE,MAAM,EAAE,GAAG,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAQzF"}

package/dist/src/storage/pathSafety.js

@@ -0,0 +1,28 @@
+import path from 'node:path';
+import { ActoviqSdkError } from '../errors.js';
+const PATH_SEPARATOR_PATTERN = /[\\/]/u;
+export function assertSafeStorageSegment(label, value) {
+    if (value.length === 0 ||
+        value === '.' ||
+        value === '..' ||
+        value.includes('\0') ||
+        PATH_SEPARATOR_PATTERN.test(value) ||
+        path.isAbsolute(value)) {
+        throw new ActoviqSdkError(`Unsafe ${label} "${value}". Storage keys must be plain path segments.`);
+    }
+    return value;
+}
+export function safeStorageFileName(label, value, extension) {
+    const segment = assertSafeStorageSegment(label, value);
+    return `${segment}.${extension.replace(/^\./u, '')}`;
+}
+export function joinUnderStorageRoot(rootDirectory, ...segments) {
+    const root = path.resolve(rootDirectory);
+    const target = path.resolve(root, ...segments);
+    const relative = path.relative(root, target);
+    if (relative === '' || relative.startsWith('..') || path.isAbsolute(relative)) {
+        throw new ActoviqSdkError(`Resolved storage path escapes its root: ${target}`);
+    }
+    return target;
+}
+//# sourceMappingURL=pathSafety.js.map

package/dist/src/storage/pathSafety.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pathSafety.js","sourceRoot":"","sources":["../../../src/storage/pathSafety.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,sBAAsB,GAAG,QAAQ,CAAC;AAExC,MAAM,UAAU,wBAAwB,CAAC,KAAa,EAAE,KAAa;IACnE,IACE,KAAK,CAAC,MAAM,KAAK,CAAC;QAClB,KAAK,KAAK,GAAG;QACb,KAAK,KAAK,IAAI;QACd,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;QACpB,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC;QAClC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,EACtB,CAAC;QACD,MAAM,IAAI,eAAe,CACvB,UAAU,KAAK,KAAK,KAAK,8CAA8C,CACxE,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,KAAa,EAAE,KAAa,EAAE,SAAiB;IACjF,MAAM,OAAO,GAAG,wBAAwB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;IACvD,OAAO,GAAG,OAAO,IAAI,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;AACvD,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,aAAqB,EAAE,GAAG,QAAkB;IAC/E,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,CAAC;IACzC,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,QAAQ,CAAC,CAAC;IAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC7C,IAAI,QAAQ,KAAK,EAAE,IAAI,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC9E,MAAM,IAAI,eAAe,CAAC,2CAA2C,MAAM,EAAE,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/src/storage/sessionStore.d.ts

@@ -1,4 +1,4 @@
-import type { SessionCheckpoint, SessionCheckpointSummary, SessionCreateOptions, SessionForkOptions, SessionSummary, StoredSession } from '../types.js';
+import type { SessionCheckpoint, SessionCheckpointSummary, SessionCreateOptions, SessionForkOptions, SessionStatus, SessionSummary, StoredSession } from '../types.js';
 export declare class SessionStore {
     private readonly rootDirectory;
     constructor(rootDirectory: string);
@@ -8,7 +8,7 @@ export declare class SessionStore {
     list(): Promise<SessionSummary[]>;
     delete(sessionId: string): Promise<void>;
     updateStatus(sessionId: string, status: import('../types.js').SessionStatus): Promise<void>;
-    updateLastActiveAt(sessionId: string): Promise<void>;
+    updateLastActiveAt(sessionId: string, status?: SessionStatus): Promise<void>;
     fork(sessionId: string, options?: SessionForkOptions): Promise<StoredSession>;
     saveCheckpoint(sessionId: string, label: string): Promise<SessionCheckpoint>;
     loadCheckpoint(sessionId: string, checkpointId: string): Promise<SessionCheckpoint>;

package/dist/src/storage/sessionStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sessionStore.d.ts","sourceRoot":"","sources":["../../../src/storage/sessionStore.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,iBAAiB,EACjB,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,cAAc,EACd,aAAa,EACd,MAAM,aAAa,CAAC;AAIrB,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAAb,aAAa,EAAE,MAAM;IAE5C,MAAM,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,aAAa,CAAC;IAuBlE,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3C,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAe/C,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAmBjC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxC,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,aAAa,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3F,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOpD,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,aAAa,CAAC;IAwBjF,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAkB5E,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAiBnF,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,EAAE,CAAC;IAsBvE,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ9E,OAAO,CAAC,oBAAoB;YAId,WAAW;IAIzB,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,SAAS;CAiBlB"}
+{"version":3,"file":"sessionStore.d.ts","sourceRoot":"","sources":["../../../src/storage/sessionStore.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,iBAAiB,EACjB,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,aAAa,EACb,cAAc,EACd,aAAa,EACd,MAAM,aAAa,CAAC;AASrB,qBAAa,YAAY;IACX,OAAO,CAAC,QAAQ,CAAC,aAAa;gBAAb,aAAa,EAAE,MAAM;IAE5C,MAAM,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,aAAa,CAAC;IAiClE,IAAI,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAM3C,IAAI,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAe/C,IAAI,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;IAmBjC,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKxC,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,aAAa,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ3F,kBAAkB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC;IAU5E,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,OAAO,GAAE,kBAAuB,GAAG,OAAO,CAAC,aAAa,CAAC;IAwBjF,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAqB5E,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAiBnF,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,wBAAwB,EAAE,CAAC;IAsBvE,gBAAgB,CAAC,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ9E,OAAO,CAAC,oBAAoB;YAQd,WAAW;IAIzB,OAAO,CAAC,iBAAiB;IAIzB,OAAO,CAAC,WAAW;IAOnB,OAAO,CAAC,SAAS;CAiBlB"}