ai-browser 0.2.1 → 0.2.2

package/dist/task/artifact-store.js

@@ -0,0 +1,115 @@
+import { randomUUID } from 'node:crypto';
+const MAX_CHUNK_SIZE = 256 * 1024; // 256KB per read
+const DEFAULT_TTL_MS = 24 * 60 * 60 * 1000; // 24 hours
+const CLEANUP_INTERVAL_MS = 5 * 60 * 1000; // 5 minutes
+export class ArtifactStore {
+    artifacts = new Map();
+    runIndex = new Map();
+    expirations = new Map();
+    cleanupTimer = null;
+    ttlMs;
+    constructor(ttlMs = DEFAULT_TTL_MS) {
+        this.ttlMs = ttlMs;
+        this.cleanupTimer = setInterval(() => this.cleanup(), CLEANUP_INTERVAL_MS);
+        if (this.cleanupTimer.unref)
+            this.cleanupTimer.unref();
+    }
+    save(runId, data, mimeType) {
+        const artifactId = randomUUID();
+        const buf = typeof data === 'string' ? Buffer.from(data, 'utf-8') : data;
+        const meta = {
+            artifactId,
+            runId,
+            mimeType,
+            size: buf.length,
+            createdAt: Date.now(),
+        };
+        this.artifacts.set(artifactId, { meta, data: buf });
+        // Update run index
+        let ids = this.runIndex.get(runId);
+        if (!ids) {
+            ids = new Set();
+            this.runIndex.set(runId, ids);
+        }
+        ids.add(artifactId);
+        return artifactId;
+    }
+    get(artifactId, offset, limit) {
+        const entry = this.artifacts.get(artifactId);
+        if (!entry)
+            return undefined;
+        const { meta, data } = entry;
+        const start = Math.min(offset ?? 0, data.length);
+        const maxLen = Math.min(limit ?? MAX_CHUNK_SIZE, MAX_CHUNK_SIZE);
+        const end = Math.min(start + maxLen, data.length);
+        const slice = data.subarray(start, end);
+        const isText = meta.mimeType.startsWith('text/') ||
+            meta.mimeType === 'application/json';
+        return {
+            artifactId,
+            mimeType: meta.mimeType,
+            totalSize: meta.size,
+            offset: start,
+            length: slice.length,
+            data: isText ? slice.toString('utf-8') : slice.toString('base64'),
+            complete: end >= data.length,
+        };
+    }
+    getMeta(artifactId) {
+        return this.artifacts.get(artifactId)?.meta;
+    }
+    listByRun(runId) {
+        const ids = this.runIndex.get(runId);
+        if (!ids)
+            return [];
+        const result = [];
+        for (const id of ids) {
+            const entry = this.artifacts.get(id);
+            if (entry)
+                result.push(entry.meta);
+        }
+        return result;
+    }
+    /**
+     * Mark artifacts for a run as expiring.
+     * Called when the associated run reaches a terminal state.
+     */
+    markExpiring(runId) {
+        const ids = this.runIndex.get(runId);
+        if (!ids)
+            return;
+        const expireAt = Date.now() + this.ttlMs;
+        for (const id of ids) {
+            this.expirations.set(id, expireAt);
+        }
+    }
+    dispose() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = null;
+        }
+        this.artifacts.clear();
+        this.runIndex.clear();
+        this.expirations.clear();
+    }
+    cleanup() {
+        const now = Date.now();
+        for (const [id, expireAt] of this.expirations) {
+            if (now >= expireAt) {
+                const entry = this.artifacts.get(id);
+                if (entry) {
+                    const runIds = this.runIndex.get(entry.meta.runId);
+                    if (runIds) {
+                        runIds.delete(id);
+                        if (runIds.size === 0) {
+                            this.runIndex.delete(entry.meta.runId);
+                        }
+                    }
+                }
+                this.artifacts.delete(id);
+                this.expirations.delete(id);
+            }
+        }
+    }
+}
+//# sourceMappingURL=artifact-store.js.map

package/dist/task/artifact-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"artifact-store.js","sourceRoot":"","sources":["../../src/task/artifact-store.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAqBzC,MAAM,cAAc,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC,iBAAiB;AACpD,MAAM,cAAc,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,WAAW;AACvD,MAAM,mBAAmB,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,YAAY;AAEvD,MAAM,OAAO,aAAa;IAChB,SAAS,GAAG,IAAI,GAAG,EAAgD,CAAC;IACpE,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAC;IAC1C,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IACxC,YAAY,GAA0C,IAAI,CAAC;IAC3D,KAAK,CAAS;IAEtB,YAAY,KAAK,GAAG,cAAc;QAChC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,mBAAmB,CAAC,CAAC;QAC3E,IAAI,IAAI,CAAC,YAAY,CAAC,KAAK;YAAE,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;IACzD,CAAC;IAED,IAAI,CAAC,KAAa,EAAE,IAAqB,EAAE,QAAgB;QACzD,MAAM,UAAU,GAAG,UAAU,EAAE,CAAC;QAChC,MAAM,GAAG,GAAG,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACzE,MAAM,IAAI,GAAiB;YACzB,UAAU;YACV,KAAK;YACL,QAAQ;YACR,IAAI,EAAE,GAAG,CAAC,MAAM;YAChB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;SACtB,CAAC;QAEF,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,CAAC,CAAC;QAEpD,mBAAmB;QACnB,IAAI,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,GAAG,GAAG,IAAI,GAAG,EAAE,CAAC;YAChB,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAChC,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAEpB,OAAO,UAAU,CAAC;IACpB,CAAC;IAED,GAAG,CAAC,UAAkB,EAAE,MAAe,EAAE,KAAc;QACrD,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC7C,IAAI,CAAC,KAAK;YAAE,OAAO,SAAS,CAAC;QAE7B,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;QAC7B,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,IAAI,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACjD,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,cAAc,EAAE,cAAc,CAAC,CAAC;QACjE,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QAClD,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAExC,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,CAAC;YAC9C,IAAI,CAAC,QAAQ,KAAK,kBAAkB,CAAC;QAEvC,OAAO;YACL,UAAU;YACV,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,SAAS,EAAE,IAAI,CAAC,IAAI;YACpB,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,QAAQ,CAAC;YACjE,QAAQ,EAAE,GAAG,IAAI,IAAI,CAAC,MAAM;SAC7B,CAAC;IACJ,CAAC;IAED,OAAO,CAAC,UAAkB;QACxB,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,IAAI,CAAC;IAC9C,CAAC;IAED,SAAS,CAAC,KAAa;QACrB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,CAAC,GAAG;YAAE,OAAO,EAAE,CAAC;QACpB,MAAM,MAAM,GAAmB,EAAE,CAAC;QAClC,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;YACrB,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YACrC,IAAI,KAAK;gBAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACrC,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;;OAGG;IACH,YAAY,CAAC,KAAa;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACrC,IAAI,CAAC,GAAG;YAAE,OAAO;QACjB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;QACzC,KAAK,MAAM,EAAE,IAAI,GAAG,EAAE,CAAC;YACrB,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAC;QACrC,CAAC;IACH,CAAC;IAED,OAAO;QACL,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;YACtB,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;YACjC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;QAC3B,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;QACvB,IAAI,CAAC,QAAQ,CAAC,KAAK,EAAE,CAAC;QACtB,IAAI,CAAC,WAAW,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;IAEO,OAAO;QACb,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,EAAE,EAAE,QAAQ,CAAC,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;YAC9C,IAAI,GAAG,IAAI,QAAQ,EAAE,CAAC;gBACpB,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;gBACrC,IAAI,KAAK,EAAE,CAAC;oBACV,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;oBACnD,IAAI,MAAM,EAAE,CAAC;wBACX,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;wBAClB,IAAI,MAAM,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;4BACtB,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;wBACzC,CAAC;oBACH,CAAC;gBACH,CAAC;gBACD,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;gBAC1B,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC9B,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/task/cancel-token.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Cooperative cancellation primitive.
+ * Passed to template executors; checked between steps.
+ */
+export declare class CancelToken {
+    private _canceled;
+    private _listeners;
+    get canceled(): boolean;
+    cancel(): void;
+    onCancel(fn: () => void): void;
+    throwIfCanceled(): void;
+}
+//# sourceMappingURL=cancel-token.d.ts.map

package/dist/task/cancel-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel-token.d.ts","sourceRoot":"","sources":["../../src/task/cancel-token.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,UAAU,CAAyB;IAE3C,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,MAAM,IAAI,IAAI;IASd,QAAQ,CAAC,EAAE,EAAE,MAAM,IAAI,GAAG,IAAI;IAQ9B,eAAe,IAAI,IAAI;CAOxB"}

package/dist/task/cancel-token.js

@@ -0,0 +1,42 @@
+import { ErrorCode } from './error-codes.js';
+/**
+ * Cooperative cancellation primitive.
+ * Passed to template executors; checked between steps.
+ */
+export class CancelToken {
+    _canceled = false;
+    _listeners = [];
+    get canceled() {
+        return this._canceled;
+    }
+    cancel() {
+        if (this._canceled)
+            return;
+        this._canceled = true;
+        for (const fn of this._listeners) {
+            try {
+                fn();
+            }
+            catch { }
+        }
+        this._listeners.length = 0;
+    }
+    onCancel(fn) {
+        if (this._canceled) {
+            try {
+                fn();
+            }
+            catch { }
+            return;
+        }
+        this._listeners.push(fn);
+    }
+    throwIfCanceled() {
+        if (this._canceled) {
+            const err = new Error('Run canceled');
+            err.errorCode = ErrorCode.RUN_CANCELED;
+            throw err;
+        }
+    }
+}
+//# sourceMappingURL=cancel-token.js.map

package/dist/task/cancel-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel-token.js","sourceRoot":"","sources":["../../src/task/cancel-token.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C;;;GAGG;AACH,MAAM,OAAO,WAAW;IACd,SAAS,GAAG,KAAK,CAAC;IAClB,UAAU,GAAsB,EAAE,CAAC;IAE3C,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,SAAS,CAAC;IACxB,CAAC;IAED,MAAM;QACJ,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,KAAK,MAAM,EAAE,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACjC,IAAI,CAAC;gBAAC,EAAE,EAAE,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;QACxB,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC;IAC7B,CAAC;IAED,QAAQ,CAAC,EAAc;QACrB,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,IAAI,CAAC;gBAAC,EAAE,EAAE,CAAC;YAAC,CAAC;YAAC,MAAM,CAAC,CAAA,CAAC;YACtB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAC3B,CAAC;IAED,eAAe;QACb,IAAI,IAAI,CAAC,SAAS,EAAE,CAAC;YACnB,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,cAAc,CAAC,CAAC;YACrC,GAAW,CAAC,SAAS,GAAG,SAAS,CAAC,YAAY,CAAC;YAChD,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC;CACF"}

package/dist/task/error-codes.d.ts

@@ -0,0 +1,19 @@
+export declare enum ErrorCode {
+    ELEMENT_NOT_FOUND = "ELEMENT_NOT_FOUND",
+    NAVIGATION_TIMEOUT = "NAVIGATION_TIMEOUT",
+    SESSION_NOT_FOUND = "SESSION_NOT_FOUND",
+    PAGE_CRASHED = "PAGE_CRASHED",
+    INVALID_PARAMETER = "INVALID_PARAMETER",
+    EXECUTION_ERROR = "EXECUTION_ERROR",
+    TEMPLATE_NOT_FOUND = "TEMPLATE_NOT_FOUND",
+    RUN_NOT_FOUND = "RUN_NOT_FOUND",
+    RUN_TIMEOUT = "RUN_TIMEOUT",
+    RUN_CANCELED = "RUN_CANCELED",
+    STEP_EXECUTION_FAILED = "STEP_EXECUTION_FAILED",
+    TRUST_LEVEL_NOT_ALLOWED = "TRUST_LEVEL_NOT_ALLOWED",
+    TEMPLATE_VERSION_UNSUPPORTED = "TEMPLATE_VERSION_UNSUPPORTED",
+    ARTIFACT_NOT_FOUND = "ARTIFACT_NOT_FOUND",
+    ARTIFACT_EXPIRED = "ARTIFACT_EXPIRED",
+    TPL_LOGIN_FIELD_NOT_FOUND = "TPL_LOGIN_FIELD_NOT_FOUND"
+}
+//# sourceMappingURL=error-codes.d.ts.map

package/dist/task/error-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../../src/task/error-codes.ts"],"names":[],"mappings":"AACA,oBAAY,SAAS;IACnB,iBAAiB,sBAAsB;IACvC,kBAAkB,uBAAuB;IACzC,iBAAiB,sBAAsB;IACvC,YAAY,iBAAiB;IAC7B,iBAAiB,sBAAsB;IACvC,eAAe,oBAAoB;IACnC,kBAAkB,uBAAuB;IACzC,aAAa,kBAAkB;IAC/B,WAAW,gBAAgB;IAE3B,YAAY,iBAAiB;IAC7B,qBAAqB,0BAA0B;IAC/C,uBAAuB,4BAA4B;IACnD,4BAA4B,iCAAiC;IAC7D,kBAAkB,uBAAuB;IACzC,gBAAgB,qBAAqB;IACrC,yBAAyB,8BAA8B;CACxD"}

package/dist/task/error-codes.js

@@ -0,0 +1,22 @@
+// Structured error codes for Agent consumption
+export var ErrorCode;
+(function (ErrorCode) {
+    ErrorCode["ELEMENT_NOT_FOUND"] = "ELEMENT_NOT_FOUND";
+    ErrorCode["NAVIGATION_TIMEOUT"] = "NAVIGATION_TIMEOUT";
+    ErrorCode["SESSION_NOT_FOUND"] = "SESSION_NOT_FOUND";
+    ErrorCode["PAGE_CRASHED"] = "PAGE_CRASHED";
+    ErrorCode["INVALID_PARAMETER"] = "INVALID_PARAMETER";
+    ErrorCode["EXECUTION_ERROR"] = "EXECUTION_ERROR";
+    ErrorCode["TEMPLATE_NOT_FOUND"] = "TEMPLATE_NOT_FOUND";
+    ErrorCode["RUN_NOT_FOUND"] = "RUN_NOT_FOUND";
+    ErrorCode["RUN_TIMEOUT"] = "RUN_TIMEOUT";
+    // v0.2 additions
+    ErrorCode["RUN_CANCELED"] = "RUN_CANCELED";
+    ErrorCode["STEP_EXECUTION_FAILED"] = "STEP_EXECUTION_FAILED";
+    ErrorCode["TRUST_LEVEL_NOT_ALLOWED"] = "TRUST_LEVEL_NOT_ALLOWED";
+    ErrorCode["TEMPLATE_VERSION_UNSUPPORTED"] = "TEMPLATE_VERSION_UNSUPPORTED";
+    ErrorCode["ARTIFACT_NOT_FOUND"] = "ARTIFACT_NOT_FOUND";
+    ErrorCode["ARTIFACT_EXPIRED"] = "ARTIFACT_EXPIRED";
+    ErrorCode["TPL_LOGIN_FIELD_NOT_FOUND"] = "TPL_LOGIN_FIELD_NOT_FOUND";
+})(ErrorCode || (ErrorCode = {}));
+//# sourceMappingURL=error-codes.js.map

package/dist/task/error-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-codes.js","sourceRoot":"","sources":["../../src/task/error-codes.ts"],"names":[],"mappings":"AAAA,+CAA+C;AAC/C,MAAM,CAAN,IAAY,SAkBX;AAlBD,WAAY,SAAS;IACnB,oDAAuC,CAAA;IACvC,sDAAyC,CAAA;IACzC,oDAAuC,CAAA;IACvC,0CAA6B,CAAA;IAC7B,oDAAuC,CAAA;IACvC,gDAAmC,CAAA;IACnC,sDAAyC,CAAA;IACzC,4CAA+B,CAAA;IAC/B,wCAA2B,CAAA;IAC3B,iBAAiB;IACjB,0CAA6B,CAAA;IAC7B,4DAA+C,CAAA;IAC/C,gEAAmD,CAAA;IACnD,0EAA6D,CAAA;IAC7D,sDAAyC,CAAA;IACzC,kDAAqC,CAAA;IACrC,oEAAuD,CAAA;AACzD,CAAC,EAlBW,SAAS,KAAT,SAAS,QAkBpB"}

package/dist/task/index.d.ts

@@ -0,0 +1,17 @@
+export type { ToolContext, TrustLevel } from './tool-context.js';
+export * as toolActions from './tool-actions.js';
+export { ErrorCode } from './error-codes.js';
+export { CancelToken } from './cancel-token.js';
+export { RunManager } from './run-manager.js';
+export type { RunState, RunStatus, RunManagerOptions } from './run-manager.js';
+export { ArtifactStore } from './artifact-store.js';
+export type { ArtifactMeta, ArtifactChunk } from './artifact-store.js';
+export { getTemplate, listTemplates } from './templates/registry.js';
+export type { TemplateMeta } from './templates/registry.js';
+export { executeBatchExtract } from './templates/batch-extract.js';
+export type { BatchExtractInputs, BatchExtractResult } from './templates/batch-extract.js';
+export { executeLoginKeepSession, LOGIN_TOTAL_STEPS } from './templates/login-keep-session.js';
+export type { LoginKeepSessionInputs, LoginKeepSessionResult } from './templates/login-keep-session.js';
+export { executeMultiTabCompare } from './templates/multi-tab-compare.js';
+export type { MultiTabCompareInputs, MultiTabCompareResult } from './templates/multi-tab-compare.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/task/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,YAAY,EAAE,QAAQ,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AACrE,YAAY,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACnE,YAAY,EAAE,kBAAkB,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AAC3F,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAC/F,YAAY,EAAE,sBAAsB,EAAE,sBAAsB,EAAE,MAAM,mCAAmC,CAAC;AACxG,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,YAAY,EAAE,qBAAqB,EAAE,qBAAqB,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/task/index.js

@@ -0,0 +1,10 @@
+export * as toolActions from './tool-actions.js';
+export { ErrorCode } from './error-codes.js';
+export { CancelToken } from './cancel-token.js';
+export { RunManager } from './run-manager.js';
+export { ArtifactStore } from './artifact-store.js';
+export { getTemplate, listTemplates } from './templates/registry.js';
+export { executeBatchExtract } from './templates/batch-extract.js';
+export { executeLoginKeepSession, LOGIN_TOTAL_STEPS } from './templates/login-keep-session.js';
+export { executeMultiTabCompare } from './templates/multi-tab-compare.js';
+//# sourceMappingURL=index.js.map

package/dist/task/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/task/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,WAAW,MAAM,mBAAmB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE9C,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,yBAAyB,CAAC;AAErE,OAAO,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAEnE,OAAO,EAAE,uBAAuB,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAE/F,OAAO,EAAE,sBAAsB,EAAE,MAAM,kCAAkC,CAAC"}

package/dist/task/run-manager.d.ts

@@ -0,0 +1,77 @@
+import { CancelToken } from './cancel-token.js';
+export type RunStatus = 'queued' | 'running' | 'succeeded' | 'failed' | 'partial_success' | 'canceled';
+export interface RunState {
+    runId: string;
+    templateId: string;
+    status: RunStatus;
+    createdAt: number;
+    updatedAt: number;
+    sessionId: string;
+    ownsSession: boolean;
+    progress: {
+        totalSteps: number;
+        doneSteps: number;
+    };
+    metrics: {
+        elapsedMs: number;
+    };
+    result?: any;
+    error?: {
+        errorCode: string;
+        message: string;
+        details?: any;
+    };
+    artifactIds: string[];
+}
+export interface RunManagerOptions {
+    ttlMs?: number;
+    maxConcurrentRuns?: number;
+}
+type TerminalHook = (run: RunState) => void | Promise<void>;
+export declare class RunManager {
+    private runs;
+    private tokens;
+    private timers;
+    private terminalHooks;
+    private cleanupTimer;
+    private ttlMs;
+    private semaphore;
+    constructor(opts?: RunManagerOptions);
+    /**
+     * Submit a run for execution.
+     * In sync mode, awaits the executor and returns the result inline.
+     * In async mode, fires the executor and returns immediately with runId.
+     */
+    submit(templateId: string, sessionId: string, ownsSession: boolean, totalSteps: number, executor: (runId: string, token: CancelToken, onProgress: (done: number) => void) => Promise<any>, opts: {
+        timeoutMs?: number;
+        mode: 'sync' | 'async';
+        onTerminal?: TerminalHook;
+    }): Promise<{
+        runId: string;
+        syncResult?: any;
+    }>;
+    get(runId: string): RunState | undefined;
+    cancel(runId: string): boolean;
+    list(filter?: {
+        status?: RunStatus;
+        templateId?: string;
+        limit?: number;
+        offset?: number;
+    }): RunState[];
+    count(filter?: {
+        status?: RunStatus;
+        templateId?: string;
+    }): number;
+    attachArtifact(runId: string, artifactId: string): void;
+    dispose(): void;
+    private createRun;
+    private transition;
+    private updateProgress;
+    private executeRun;
+    private fireTerminalHook;
+    private determineStatus;
+    private filterRuns;
+    private cleanup;
+}
+export {};
+//# sourceMappingURL=run-manager.d.ts.map

package/dist/task/run-manager.d.ts.map

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

package/dist/task/run-manager.js

@@ -0,0 +1,286 @@
+import { randomUUID } from 'node:crypto';
+import { CancelToken } from './cancel-token.js';
+import { ErrorCode } from './error-codes.js';
+const TERMINAL_STATUSES = new Set([
+    'succeeded', 'failed', 'partial_success', 'canceled',
+]);
+// ===== Semaphore for concurrency control =====
+class Semaphore {
+    _count;
+    _waiters = [];
+    constructor(max) {
+        this._count = max;
+    }
+    async acquire() {
+        if (this._count > 0) {
+            this._count--;
+            return;
+        }
+        return new Promise((resolve) => {
+            this._waiters.push(resolve);
+        });
+    }
+    release() {
+        const next = this._waiters.shift();
+        if (next) {
+            next();
+        }
+        else {
+            this._count++;
+        }
+    }
+}
+// ===== RunManager =====
+const DEFAULT_TTL_MS = 30 * 60 * 1000; // 30 minutes
+const CLEANUP_INTERVAL_MS = 5 * 60 * 1000; // 5 minutes
+const DEFAULT_MAX_CONCURRENT = 5;
+export class RunManager {
+    runs = new Map();
+    tokens = new Map();
+    timers = new Map();
+    terminalHooks = new Map();
+    cleanupTimer = null;
+    ttlMs;
+    semaphore;
+    constructor(opts) {
+        this.ttlMs = opts?.ttlMs ?? DEFAULT_TTL_MS;
+        this.semaphore = new Semaphore(opts?.maxConcurrentRuns ?? DEFAULT_MAX_CONCURRENT);
+        this.cleanupTimer = setInterval(() => this.cleanup(), CLEANUP_INTERVAL_MS);
+        if (this.cleanupTimer.unref)
+            this.cleanupTimer.unref();
+    }
+    /**
+     * Submit a run for execution.
+     * In sync mode, awaits the executor and returns the result inline.
+     * In async mode, fires the executor and returns immediately with runId.
+     */
+    async submit(templateId, sessionId, ownsSession, totalSteps, executor, opts) {
+        const run = this.createRun(templateId, sessionId, ownsSession, totalSteps);
+        const token = new CancelToken();
+        this.tokens.set(run.runId, token);
+        if (opts.onTerminal) {
+            this.terminalHooks.set(run.runId, opts.onTerminal);
+        }
+        if (opts.mode === 'sync') {
+            const result = await this.executeRun(run.runId, executor, token, opts.timeoutMs);
+            return { runId: run.runId, syncResult: result };
+        }
+        // Async: fire-and-forget
+        this.executeRun(run.runId, executor, token, opts.timeoutMs).catch(() => { });
+        return { runId: run.runId };
+    }
+    get(runId) {
+        return this.runs.get(runId);
+    }
+    cancel(runId) {
+        const run = this.runs.get(runId);
+        if (!run)
+            return false;
+        if (TERMINAL_STATUSES.has(run.status))
+            return false;
+        const token = this.tokens.get(runId);
+        if (token)
+            token.cancel();
+        this.transition(runId, 'canceled');
+        run.error = { errorCode: ErrorCode.RUN_CANCELED, message: 'Run canceled by user' };
+        return true;
+    }
+    list(filter) {
+        const results = this.filterRuns(filter);
+        const offset = filter?.offset ?? 0;
+        const limit = filter?.limit ?? 50;
+        return results.slice(offset, offset + limit);
+    }
+    count(filter) {
+        return this.filterRuns(filter).length;
+    }
+    attachArtifact(runId, artifactId) {
+        const run = this.runs.get(runId);
+        if (!run)
+            return;
+        run.artifactIds.push(artifactId);
+        run.updatedAt = Date.now();
+    }
+    dispose() {
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = null;
+        }
+        for (const timer of this.timers.values()) {
+            clearTimeout(timer);
+        }
+        this.timers.clear();
+        for (const token of this.tokens.values()) {
+            token.cancel();
+        }
+        this.tokens.clear();
+        this.terminalHooks.clear();
+        this.runs.clear();
+    }
+    // --- Internal helpers ---
+    createRun(templateId, sessionId, ownsSession, totalSteps) {
+        const now = Date.now();
+        const run = {
+            runId: randomUUID(),
+            templateId,
+            status: 'queued',
+            createdAt: now,
+            updatedAt: now,
+            sessionId,
+            ownsSession,
+            progress: { totalSteps, doneSteps: 0 },
+            metrics: { elapsedMs: 0 },
+            artifactIds: [],
+        };
+        this.runs.set(run.runId, run);
+        return run;
+    }
+    transition(runId, status) {
+        const run = this.runs.get(runId);
+        if (!run)
+            return;
+        if (TERMINAL_STATUSES.has(run.status))
+            return;
+        run.status = status;
+        run.updatedAt = Date.now();
+        if (TERMINAL_STATUSES.has(status)) {
+            run.metrics.elapsedMs = run.updatedAt - run.createdAt;
+            // Cleanup token and timer
+            this.tokens.delete(runId);
+            const timer = this.timers.get(runId);
+            if (timer) {
+                clearTimeout(timer);
+                this.timers.delete(runId);
+            }
+        }
+    }
+    updateProgress(runId, doneSteps) {
+        const run = this.runs.get(runId);
+        if (!run || TERMINAL_STATUSES.has(run.status))
+            return;
+        run.progress.doneSteps = doneSteps;
+        run.updatedAt = Date.now();
+    }
+    async executeRun(runId, executor, token, timeoutMs) {
+        // Acquire semaphore slot
+        await this.semaphore.acquire();
+        try {
+            // Check if canceled while waiting for semaphore
+            if (token.canceled) {
+                this.transition(runId, 'canceled');
+                return undefined;
+            }
+            this.transition(runId, 'running');
+            // Setup timeout
+            const timeout = Math.min(timeoutMs ?? 300_000, 600_000);
+            const timeoutTimer = setTimeout(() => {
+                const run = this.runs.get(runId);
+                if (run && run.status === 'running') {
+                    token.cancel();
+                    run.error = {
+                        errorCode: ErrorCode.RUN_TIMEOUT,
+                        message: 'Execution timed out',
+                    };
+                    this.transition(runId, 'failed');
+                }
+            }, timeout);
+            this.timers.set(runId, timeoutTimer);
+            // Execute
+            const result = await executor(runId, token, (done) => this.updateProgress(runId, done));
+            // Check if already transitioned (timeout/cancel)
+            const run = this.runs.get(runId);
+            if (!run) {
+                return undefined;
+            }
+            if (TERMINAL_STATUSES.has(run.status)) {
+                // Preserve partial results even if status has already been finalized.
+                if (run.result === undefined && result !== undefined) {
+                    run.result = result;
+                }
+                return run.result;
+            }
+            // Determine final status from result
+            run.result = result;
+            const status = this.determineStatus(result);
+            this.transition(runId, status);
+            return result;
+        }
+        catch (err) {
+            const run = this.runs.get(runId);
+            if (run && TERMINAL_STATUSES.has(run.status)) {
+                return run.result;
+            }
+            if (run && !TERMINAL_STATUSES.has(run.status)) {
+                run.error = {
+                    errorCode: err.errorCode ?? ErrorCode.EXECUTION_ERROR,
+                    message: err.message || 'Execution failed',
+                };
+                this.transition(runId, 'failed');
+            }
+            throw err;
+        }
+        finally {
+            this.semaphore.release();
+            await this.fireTerminalHook(runId);
+        }
+    }
+    async fireTerminalHook(runId) {
+        const run = this.runs.get(runId);
+        if (!run || !TERMINAL_STATUSES.has(run.status)) {
+            return;
+        }
+        const hook = this.terminalHooks.get(runId);
+        if (!hook) {
+            return;
+        }
+        this.terminalHooks.delete(runId);
+        try {
+            await hook(run);
+        }
+        catch {
+            // Ignore terminal hook failures to avoid masking run status.
+        }
+    }
+    determineStatus(result) {
+        if (result?.summary && typeof result.summary.succeeded === 'number' && typeof result.summary.total === 'number') {
+            const { succeeded, total } = result.summary;
+            if (succeeded === total)
+                return 'succeeded';
+            if (total > 0 && succeeded / total >= 0.5)
+                return 'partial_success';
+            return 'failed';
+        }
+        if (typeof result?.success === 'boolean') {
+            return result.success ? 'succeeded' : 'failed';
+        }
+        return 'succeeded';
+    }
+    filterRuns(filter) {
+        let results = Array.from(this.runs.values());
+        if (filter?.status) {
+            results = results.filter((r) => r.status === filter.status);
+        }
+        if (filter?.templateId) {
+            results = results.filter((r) => r.templateId === filter.templateId);
+        }
+        // Sort by createdAt descending (newest first)
+        results.sort((a, b) => b.createdAt - a.createdAt);
+        return results;
+    }
+    cleanup() {
+        const now = Date.now();
+        for (const [id, run] of this.runs) {
+            if (TERMINAL_STATUSES.has(run.status) && now - run.updatedAt > this.ttlMs) {
+                this.runs.delete(id);
+                this.tokens.delete(id);
+                this.terminalHooks.delete(id);
+                const timer = this.timers.get(id);
+                if (timer) {
+                    clearTimeout(timer);
+                    this.timers.delete(id);
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=run-manager.js.map