tabwright 1.0.0

package/dist/wait-for-page-load.js

@@ -0,0 +1,146 @@
+import { sleep } from './utils.js';
+const FILTERED_DOMAINS = [
+    'doubleclick',
+    'googlesyndication',
+    'googleadservices',
+    'google-analytics',
+    'googletagmanager',
+    'facebook.net',
+    'fbcdn.net',
+    'twitter.com',
+    'linkedin.com',
+    'hotjar',
+    'mixpanel',
+    'segment.io',
+    'segment.com',
+    'newrelic',
+    'datadoghq',
+    'sentry.io',
+    'fullstory',
+    'amplitude',
+    'intercom',
+    'crisp.chat',
+    'zdassets.com',
+    'zendesk',
+    'tawk.to',
+    'hubspot',
+    'marketo',
+    'pardot',
+    'optimizely',
+    'crazyegg',
+    'mouseflow',
+    'clarity.ms',
+    'bing.com/bat',
+    'ads.',
+    'analytics.',
+    'tracking.',
+    'pixel.',
+];
+const FILTERED_EXTENSIONS = ['.gif', '.ico', '.cur', '.woff', '.woff2', '.ttf', '.otf', '.eot'];
+export async function waitForPageLoad(options) {
+    const { page, timeout = 30000, pollInterval = 100, minWait = 500 } = options;
+    const startTime = Date.now();
+    let timedOut = false;
+    let lastReadyState = '';
+    let lastPendingRequests = [];
+    const checkPageReady = async () => {
+        const result = await page.evaluate(({ filteredDomains, filteredExtensions, stuckThreshold, slowResourceThreshold, }) => {
+            const doc = globalThis.document;
+            const readyState = doc.readyState;
+            if (readyState !== 'complete') {
+                return { ready: false, readyState, pendingRequests: [`document.readyState: ${readyState}`] };
+            }
+            const resources = performance.getEntriesByType('resource');
+            const now = performance.now();
+            const pendingRequests = resources
+                .filter((r) => {
+                if (r.responseEnd > 0) {
+                    return false;
+                }
+                const elapsed = now - r.startTime;
+                const url = r.name.toLowerCase();
+                if (url.startsWith('data:')) {
+                    return false;
+                }
+                if (filteredDomains.some((domain) => url.includes(domain))) {
+                    return false;
+                }
+                if (elapsed > stuckThreshold) {
+                    return false;
+                }
+                if (elapsed > slowResourceThreshold && filteredExtensions.some((ext) => url.includes(ext))) {
+                    return false;
+                }
+                return true;
+            })
+                .map((r) => r.name);
+            return {
+                ready: pendingRequests.length === 0,
+                readyState,
+                pendingRequests,
+            };
+        }, {
+            filteredDomains: FILTERED_DOMAINS,
+            filteredExtensions: FILTERED_EXTENSIONS,
+            stuckThreshold: 10000,
+            slowResourceThreshold: 3000,
+        });
+        return result;
+    };
+    // Fast path: check immediately first. If already ready, return without waiting.
+    try {
+        const firstCheck = await checkPageReady();
+        if (firstCheck.ready) {
+            return {
+                success: true,
+                readyState: firstCheck.readyState,
+                pendingRequests: [],
+                waitTimeMs: Date.now() - startTime,
+                timedOut: false,
+            };
+        }
+        lastReadyState = firstCheck.readyState;
+        lastPendingRequests = firstCheck.pendingRequests;
+    }
+    catch (e) {
+        // First check failed, continue with polling
+    }
+    // Not ready yet - wait minWait to let JS settle and catch late-starting requests
+    await sleep(minWait);
+    while (Date.now() - startTime < timeout) {
+        try {
+            const { ready, readyState, pendingRequests } = await checkPageReady();
+            lastReadyState = readyState;
+            lastPendingRequests = pendingRequests;
+            if (ready) {
+                return {
+                    success: true,
+                    readyState,
+                    pendingRequests: [],
+                    waitTimeMs: Date.now() - startTime,
+                    timedOut: false,
+                };
+            }
+        }
+        catch (e) {
+            console.error('[waitForPageLoad] page.evaluate failed:', e);
+            return {
+                success: false,
+                readyState: 'error',
+                pendingRequests: ['page.evaluate failed - page may have closed or navigated'],
+                waitTimeMs: Date.now() - startTime,
+                timedOut: false,
+            };
+        }
+        await sleep(pollInterval);
+    }
+    timedOut = true;
+    return {
+        success: false,
+        readyState: lastReadyState,
+        pendingRequests: lastPendingRequests.slice(0, 10),
+        waitTimeMs: Date.now() - startTime,
+        timedOut,
+    };
+}
+//# sourceMappingURL=wait-for-page-load.js.map

package/dist/wait-for-page-load.js.map

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

package/dist/workflow-capability.d.ts

@@ -0,0 +1,72 @@
+import { type CapabilityExample, type CapabilityLocation, type CapabilitySideEffect } from './capability-registry.js';
+export interface SaveWorkflowCapabilityOptions {
+    id: string;
+    title: string;
+    description?: string;
+    script: string;
+    cwd?: string;
+    location?: CapabilityLocation;
+    overwrite?: boolean;
+    sourceRecordingId?: string;
+    whenToUse?: string[];
+    whenNotToUse?: string[];
+    match?: string[];
+    tags?: string[];
+    inputSchema?: Record<string, unknown>;
+    outputSchema?: Record<string, unknown>;
+    examples?: CapabilityExample[];
+    sideEffect?: CapabilitySideEffect;
+    requiresConfirmation?: boolean;
+}
+export interface SavedWorkflowCapability {
+    capability: Record<string, unknown>;
+    script: string;
+}
+type WorkflowValue = {
+    inputPath: string;
+    fallback?: unknown;
+} | {
+    value: unknown;
+};
+export type RecordingWorkflowStep = {
+    action: 'goto';
+    url: string | WorkflowValue;
+} | {
+    action: 'fill';
+    locator: string;
+    value: WorkflowValue;
+} | {
+    action: 'click';
+    locator: string;
+} | {
+    action: 'setInputFiles';
+    locator: string;
+    path: WorkflowValue;
+} | {
+    action: 'selectOption';
+    locator: string;
+    value: WorkflowValue;
+} | {
+    action: 'waitForURL';
+    url: string | WorkflowValue;
+};
+export interface RecordingWorkflowFinalRequest {
+    url: string;
+    method?: string | string[];
+    title?: string;
+    description?: string;
+    trigger: RecordingWorkflowStep;
+}
+export interface SaveWorkflowFromRecordingOptions extends Omit<SaveWorkflowCapabilityOptions, 'script' | 'sourceRecordingId'> {
+    recordingId: string;
+    steps: RecordingWorkflowStep[];
+    finalRequest?: RecordingWorkflowFinalRequest;
+    batch?: {
+        inputPath?: string;
+        continueOnError?: boolean;
+    };
+}
+export declare function saveWorkflowCapability(options: SaveWorkflowCapabilityOptions): SavedWorkflowCapability;
+export declare function saveWorkflowFromRecording(options: SaveWorkflowFromRecordingOptions): SavedWorkflowCapability;
+export {};
+//# sourceMappingURL=workflow-capability.d.ts.map

package/dist/workflow-capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-capability.d.ts","sourceRoot":"","sources":["../src/workflow-capability.ts"],"names":[],"mappings":"AAAA,OAAO,EAML,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EAEvB,KAAK,oBAAoB,EAC1B,MAAM,0BAA0B,CAAA;AAEjC,MAAM,WAAW,6BAA6B;IAC5C,EAAE,EAAE,MAAM,CAAA;IACV,KAAK,EAAE,MAAM,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,CAAC,EAAE,MAAM,CAAA;IACZ,QAAQ,CAAC,EAAE,kBAAkB,CAAA;IAC7B,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,iBAAiB,CAAC,EAAE,MAAM,CAAA;IAC1B,SAAS,CAAC,EAAE,MAAM,EAAE,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAA;IACvB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAA;IACf,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACrC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACtC,QAAQ,CAAC,EAAE,iBAAiB,EAAE,CAAA;IAC9B,UAAU,CAAC,EAAE,oBAAoB,CAAA;IACjC,oBAAoB,CAAC,EAAE,OAAO,CAAA;CAC/B;AAED,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IACnC,MAAM,EAAE,MAAM,CAAA;CACf;AAED,KAAK,aAAa,GACd;IACE,SAAS,EAAE,MAAM,CAAA;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAA;CACnB,GACD;IACE,KAAK,EAAE,OAAO,CAAA;CACf,CAAA;AAEL,MAAM,MAAM,qBAAqB,GAC7B;IACE,MAAM,EAAE,MAAM,CAAA;IACd,GAAG,EAAE,MAAM,GAAG,aAAa,CAAA;CAC5B,GACD;IACE,MAAM,EAAE,MAAM,CAAA;IACd,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,aAAa,CAAA;CACrB,GACD;IACE,MAAM,EAAE,OAAO,CAAA;IACf,OAAO,EAAE,MAAM,CAAA;CAChB,GACD;IACE,MAAM,EAAE,eAAe,CAAA;IACvB,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,aAAa,CAAA;CACpB,GACD;IACE,MAAM,EAAE,cAAc,CAAA;IACtB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,EAAE,aAAa,CAAA;CACrB,GACD;IACE,MAAM,EAAE,YAAY,CAAA;IACpB,GAAG,EAAE,MAAM,GAAG,aAAa,CAAA;CAC5B,CAAA;AAEL,MAAM,WAAW,6BAA6B;IAC5C,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,CAAA;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,EAAE,qBAAqB,CAAA;CAC/B;AAED,MAAM,WAAW,gCACf,SAAQ,IAAI,CAAC,6BAA6B,EAAE,QAAQ,GAAG,mBAAmB,CAAC;IAC3E,WAAW,EAAE,MAAM,CAAA;IACnB,KAAK,EAAE,qBAAqB,EAAE,CAAA;IAC9B,YAAY,CAAC,EAAE,6BAA6B,CAAA;IAC5C,KAAK,CAAC,EAAE;QACN,SAAS,CAAC,EAAE,MAAM,CAAA;QAClB,eAAe,CAAC,EAAE,OAAO,CAAA;KAC1B,CAAA;CACF;AA6DD,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,6BAA6B,GAAG,uBAAuB,CAMtG;AA2PD,wBAAgB,yBAAyB,CAAC,OAAO,EAAE,gCAAgC,GAAG,uBAAuB,CAM5G"}

package/dist/workflow-capability.js

@@ -0,0 +1,316 @@
+import { createCapability, readCapabilityScript, toCapabilitySummary, updateCapabilityManifest, updateCapabilityScript, } from './capability-registry.js';
+function workflowTags(options) {
+    const tags = new Set(['workflow', 'recording-derived', ...(options.tags || [])]);
+    if (options.sourceRecordingId) {
+        tags.add(`recording:${options.sourceRecordingId}`);
+    }
+    return Array.from(tags);
+}
+function workflowWhenToUse(options) {
+    const whenToUse = options.whenToUse || [];
+    if (whenToUse.length > 0) {
+        return whenToUse;
+    }
+    return [
+        options.description ||
+            `Run the workflow generated from recording ${options.sourceRecordingId || 'a user demonstration'}.`,
+    ];
+}
+function saveScriptCapability(options) {
+    const capability = createCapability({
+        id: options.id,
+        title: options.title,
+        description: options.description,
+        location: options.location || 'project',
+        cwd: options.cwd,
+        overwrite: options.overwrite,
+        createdBy: 'ai',
+        runtime: 'browser',
+    });
+    updateCapabilityScript({
+        id: capability.manifest.id,
+        cwd: options.cwd,
+        source: options.script,
+    });
+    return updateCapabilityManifest({
+        id: capability.manifest.id,
+        cwd: options.cwd,
+        patch: {
+            description: options.description || capability.manifest.description,
+            whenToUse: workflowWhenToUse(options),
+            whenNotToUse: options.whenNotToUse || [],
+            match: options.match || [],
+            tags: workflowTags(options),
+            inputSchema: options.inputSchema || { type: 'object', properties: {}, required: [] },
+            outputSchema: options.outputSchema || { type: 'object', properties: {} },
+            permissions: ['browser.read', 'browser.write'],
+            sideEffect: options.sideEffect || 'write',
+            requiresConfirmation: options.requiresConfirmation ?? true,
+            examples: options.examples || [],
+            status: 'draft',
+            createdBy: 'ai',
+            runtime: 'browser',
+        },
+    });
+}
+export function saveWorkflowCapability(options) {
+    const capability = saveScriptCapability(options);
+    return {
+        capability: toCapabilitySummary(capability),
+        script: readCapabilityScript({ id: capability.manifest.id, cwd: options.cwd }),
+    };
+}
+function workflowLiteral(value) {
+    return JSON.stringify(value, null, 2);
+}
+function buildWorkflowScript(options) {
+    const continueOnError = options.batch?.continueOnError ?? false;
+    const batchInputPath = options.batch?.inputPath || 'items';
+    return [
+        '// Generated from a user recording: run fast by default, and return needs_ai when the live page diverges.',
+        `const workflowSteps = ${workflowLiteral(options.steps)};`,
+        `const finalRequest = ${workflowLiteral(options.finalRequest)};`,
+        `const batchInputPath = ${workflowLiteral(batchInputPath)};`,
+        `const sourceRecordingId = ${workflowLiteral(options.recordingId)};`,
+        `const continueOnError = ${continueOnError ? 'true' : 'false'};`,
+        '',
+        'function getPathValue(source, path, fallback) {',
+        '  if (!path) return fallback;',
+        '  const parts = path.split(".").filter((part) => part.length > 0);',
+        '  const value = parts.reduce((current, part) => {',
+        '    if (!current || typeof current !== "object") return undefined;',
+        '    if (!Object.prototype.hasOwnProperty.call(current, part)) return undefined;',
+        '    return current[part];',
+        '  }, source);',
+        '  return value === undefined ? fallback : value;',
+        '}',
+        '',
+        'function resolveWorkflowValue(item, value) {',
+        '  if (typeof value === "string") return value;',
+        '  if (!value || typeof value !== "object") return value;',
+        '  if (Object.prototype.hasOwnProperty.call(value, "inputPath")) return getPathValue(item, value.inputPath, value.fallback);',
+        '  if (Object.prototype.hasOwnProperty.call(value, "value")) return value.value;',
+        '  return value;',
+        '}',
+        '',
+        'function errorMessage(error) {',
+        '  if (error && typeof error === "object" && typeof error.message === "string") return error.message;',
+        '  return String(error);',
+        '}',
+        '',
+        'function escapeRegex(value) {',
+        '  return value.replace(/[.*+?^${}()|[\\]\\\\]/g, "\\\\$&");',
+        '}',
+        '',
+        'function globToRegExp(pattern) {',
+        '  return new RegExp("^" + String(pattern).split("*").map(escapeRegex).join(".*") + "$");',
+        '}',
+        '',
+        'function normalizedMethods(method) {',
+        '  if (Array.isArray(method)) return method.map((item) => String(item).toUpperCase());',
+        '  if (method) return [String(method).toUpperCase()];',
+        '  return ["POST", "PUT", "PATCH", "DELETE"];',
+        '}',
+        '',
+        'function requestMatchesFinalRequest(request) {',
+        '  if (!finalRequest || !finalRequest.url) return false;',
+        '  const methods = normalizedMethods(finalRequest.method);',
+        '  if (!methods.includes(request.method().toUpperCase())) return false;',
+        '  return globToRegExp(finalRequest.url).test(request.url());',
+        '}',
+        '',
+        'async function readSnapshotText() {',
+        '  if (typeof snapshot !== "function") return undefined;',
+        '  try {',
+        '    const value = await snapshot({ page });',
+        '    const text = typeof value === "string" ? value : JSON.stringify(value, null, 2);',
+        '    return text.slice(0, 12000);',
+        '  } catch (error) {',
+        '    return "snapshot failed: " + errorMessage(error);',
+        '  }',
+        '}',
+        '',
+        'async function captureWorkflowContext({ step, item, index, phase, reason, error }) {',
+        '  return {',
+        '    status: "needs_ai",',
+        '    reason,',
+        '    error: error ? errorMessage(error) : undefined,',
+        '    phase,',
+        '    step,',
+        '    item,',
+        '    index,',
+        '    sourceRecordingId,',
+        '    context: {',
+        '      url: page.url(),',
+        '      title: await page.title().catch(() => ""),',
+        '      snapshot: await readSnapshotText(),',
+        '    },',
+        '  };',
+        '}',
+        '',
+        'async function getWorkflowLocator(step, item, index, phase) {',
+        '  const target = page.locator(step.locator).first();',
+        '  try {',
+        '    await target.waitFor({ state: "attached", timeout: 2500 });',
+        '    return { target };',
+        '  } catch (error) {',
+        '    return {',
+        '      handoff: await captureWorkflowContext({',
+        '        step,',
+        '        item,',
+        '        index,',
+        '        phase,',
+        '        reason: "Expected locator was not found on the live page.",',
+        '        error,',
+        '      }),',
+        '    };',
+        '  }',
+        '}',
+        '',
+        'async function runWorkflowStep(step, item, options) {',
+        '  const index = options.index;',
+        '  const phase = options.phase;',
+        '  try {',
+        '    if (step.action === "goto") {',
+        '      await page.goto(String(resolveWorkflowValue(item, step.url)));',
+        '      return { status: "ok" };',
+        '    }',
+        '    if (step.action === "waitForURL") {',
+        '      await page.waitForURL(String(resolveWorkflowValue(item, step.url)));',
+        '      return { status: "ok" };',
+        '    }',
+        '    if (!step.locator) {',
+        '      return await captureWorkflowContext({ step, item, index, phase, reason: "Workflow step is missing a locator." });',
+        '    }',
+        '    const located = await getWorkflowLocator(step, item, index, phase);',
+        '    if (located.handoff) return located.handoff;',
+        '    if (step.action === "fill") {',
+        '      await located.target.fill(String(resolveWorkflowValue(item, step.value) ?? ""));',
+        '      return { status: "ok" };',
+        '    }',
+        '    if (step.action === "click") {',
+        '      await located.target.click();',
+        '      return { status: "ok" };',
+        '    }',
+        '    if (step.action === "setInputFiles") {',
+        '      await located.target.setInputFiles(String(resolveWorkflowValue(item, step.path)));',
+        '      return { status: "ok" };',
+        '    }',
+        '    if (step.action === "selectOption") {',
+        '      await located.target.selectOption(String(resolveWorkflowValue(item, step.value)));',
+        '      return { status: "ok" };',
+        '    }',
+        '    return await captureWorkflowContext({ step, item, index, phase, reason: "Unsupported workflow step." });',
+        '  } catch (error) {',
+        '    return await captureWorkflowContext({ step, item, index, phase, reason: "Workflow step failed on the live page.", error });',
+        '  }',
+        '}',
+        '',
+        'async function runFinalRequestTrigger(item, index) {',
+        '  if (!finalRequest || !finalRequest.trigger) return { status: "completed" };',
+        '  const requestPromise = page.waitForRequest((request) => {',
+        '    return requestMatchesFinalRequest(request);',
+        '  }, { timeout: 8000 }).catch((error) => {',
+        '    return { error };',
+        '  });',
+        '  const triggerResult = await runWorkflowStep(finalRequest.trigger, item, { index, phase: "final-request" });',
+        '  if (triggerResult.status !== "ok") return triggerResult;',
+        '  const request = await requestPromise;',
+        '  if (request && request.error) {',
+        '    return await captureWorkflowContext({',
+        '      step: finalRequest.trigger,',
+        '      item,',
+        '      index,',
+        '      phase: "final-request",',
+        '      reason: "The expected final request was not observed after the trigger.",',
+        '      error: request.error,',
+        '    });',
+        '  }',
+        '  const response = await request.response().catch(() => null);',
+        '  return {',
+        '    status: "completed",',
+        '    finalRequest: {',
+        '      method: request.method(),',
+        '      url: request.url(),',
+        '      headers: request.headers(),',
+        '      postData: request.postData(),',
+        '      responseStatus: response ? response.status() : undefined,',
+        '    },',
+        '  };',
+        '}',
+        '',
+        'async function runOneWorkflowItem({ item, index }) {',
+        '  for (let stepIndex = 0; stepIndex < workflowSteps.length; stepIndex += 1) {',
+        '    const step = workflowSteps[stepIndex];',
+        '    const result = await runWorkflowStep(step, item, { index, phase: "step-" + (stepIndex + 1) });',
+        '    if (result.status !== "ok") return result;',
+        '  }',
+        '  if (!finalRequest || !finalRequest.trigger) {',
+        '    return {',
+        '      status: "completed",',
+        '      item,',
+        '      index,',
+        '    };',
+        '  }',
+        '  const finalResult = await runFinalRequestTrigger(item, index);',
+        '  if (finalResult.status !== "completed") return finalResult;',
+        '  return {',
+        '    status: "completed",',
+        '    item,',
+        '    index,',
+        '    finalRequest: finalResult.finalRequest,',
+        '  };',
+        '}',
+        '',
+        'const batchInput = getPathValue(input, batchInputPath, undefined);',
+        'const items = Array.isArray(batchInput) ? batchInput : [input];',
+        'const results = [];',
+        'let completed = 0;',
+        'let failed = 0;',
+        'let needsAi = null;',
+        'for (let index = 0; index < items.length; index += 1) {',
+        '  const item = items[index];',
+        '  try {',
+        '    const result = await runOneWorkflowItem({ item, index });',
+        '    results.push(result);',
+        '    if (result.status === "completed") {',
+        '      completed += 1;',
+        '    } else if (result.status === "needs_ai") {',
+        '      needsAi = result;',
+        '      if (!continueOnError) break;',
+        '    } else {',
+        '      failed += 1;',
+        '      if (!continueOnError) break;',
+        '    }',
+        '  } catch (error) {',
+        '    const result = await captureWorkflowContext({',
+        '      item,',
+        '      index,',
+        '      phase: "item",',
+        '      reason: "Workflow item failed before completion.",',
+        '      error,',
+        '    });',
+        '    results.push(result);',
+        '    needsAi = result;',
+        '    if (!continueOnError) break;',
+        '  }',
+        '}',
+        'return {',
+        '  status: needsAi ? "needs_ai" : failed > 0 ? "failed" : "completed",',
+        '  total: items.length,',
+        '  completed,',
+        '  failed,',
+        '  needsAi,',
+        '  results,',
+        '};',
+        '',
+    ].join('\n');
+}
+export function saveWorkflowFromRecording(options) {
+    return saveWorkflowCapability({
+        ...options,
+        sourceRecordingId: options.recordingId,
+        script: buildWorkflowScript(options),
+    });
+}
+//# sourceMappingURL=workflow-capability.js.map

package/dist/workflow-capability.js.map

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

package/dist/workflow-script-flow.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=workflow-script-flow.test.d.ts.map

package/dist/workflow-script-flow.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-script-flow.test.d.ts","sourceRoot":"","sources":["../src/workflow-script-flow.test.ts"],"names":[],"mappings":""}