@timetotest/cli 0.1.10 → 0.2.0

package/dist/src/lib/local-tools/ui/snapshot-query.js

@@ -0,0 +1,129 @@
+import { parseSnapshot } from "./playwright-mcp.js";
+import Fuse from "fuse.js";
+function createSearchableText(node) {
+    return [
+        node.name,
+        node.description,
+        node.value,
+        node.url,
+        JSON.stringify(node.attributes ?? {}),
+    ]
+        .filter(Boolean)
+        .join(" ");
+}
+function matchNode(node, args, fuse) {
+    const { text, threshold = 0.4 } = args;
+    // Text matching with fuzzy search
+    if (text) {
+        const searchableText = createSearchableText(node);
+        // Split text query into individual words and search each one
+        const words = text
+            .toLowerCase()
+            .split(/\s+/)
+            .filter((word) => word.length > 0);
+        // Check if any word matches this node
+        for (const word of words) {
+            const results = fuse.search(word);
+            const match = results.find((result) => result.item === searchableText && (result.score ?? 1) <= threshold);
+            if (match) {
+                return true;
+            }
+        }
+        return false;
+    }
+    return true;
+}
+function collectMatches(node, path, args, out, limit, fuse) {
+    if (matchNode(node, args, fuse)) {
+        out.push({
+            ref: node.ref,
+            role: node.role,
+            name: node.name,
+            description: node.description,
+            attributes: node.attributes,
+            path: [...path, node.role ?? "node"].filter(Boolean).join(" > ").trim(),
+        });
+    }
+    if (out.length >= limit)
+        return;
+    if (Array.isArray(node.children)) {
+        for (const child of node.children) {
+            collectMatches(child, [...path, node.role ?? node.name ?? "node"], args, out, limit, fuse);
+            if (out.length >= limit)
+                return;
+        }
+    }
+}
+export function snapshotQuery(ctx, args) {
+    const snapshot = ctx.snapshotCache?.ariaSnapshot;
+    if (!snapshot) {
+        return {
+            success: false,
+            error: "Snapshot cache empty. Allow the CLI to refresh it (e.g., by navigating or interacting with the page) before querying.",
+        };
+    }
+    // Validate minimum word count for text search
+    if (args.text) {
+        const wordCount = args.text
+            .trim()
+            .split(/\s+/)
+            .filter((word) => word.length > 0).length;
+        if (wordCount < 5) {
+            return {
+                success: false,
+                error: `Text search requires at least 5 words for effective searching. Provided: ${wordCount} words.`,
+            };
+        }
+    }
+    const limit = typeof args.limit === "number" && args.limit > 0 ? args.limit : 10;
+    const parsed = parseSnapshot(snapshot);
+    if (!parsed.length) {
+        return {
+            success: false,
+            error: "Snapshot cache is present but could not be parsed.",
+        };
+    }
+    // Create Fuse instance for fuzzy search
+    const searchableTexts = [];
+    const nodeTextMap = new Map();
+    // Collect all searchable texts and map them to nodes
+    function collectTexts(node) {
+        const text = createSearchableText(node);
+        if (text.trim()) {
+            searchableTexts.push(text);
+            nodeTextMap.set(text, node);
+        }
+        if (Array.isArray(node.children)) {
+            for (const child of node.children) {
+                collectTexts(child);
+            }
+        }
+    }
+    for (const node of parsed) {
+        collectTexts(node);
+    }
+    // Configure Fuse for fuzzy search
+    const fuse = new Fuse(searchableTexts, {
+        includeScore: true,
+        threshold: args.threshold || 0.4,
+        ignoreLocation: true,
+        findAllMatches: true,
+    });
+    const matches = [];
+    for (const node of parsed) {
+        collectMatches(node, [], args, matches, limit, fuse);
+        if (matches.length >= limit)
+            break;
+    }
+    return {
+        success: true,
+        query: {
+            text: args.text,
+            limit,
+            threshold: args.threshold || 0.4,
+        },
+        match_count: matches.length,
+        matches,
+    };
+}
+//# sourceMappingURL=snapshot-query.js.map

package/dist/src/lib/local-tools/ui/snapshot-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-query.js","sourceRoot":"","sources":["../../../../../src/lib/local-tools/ui/snapshot-query.ts"],"names":[],"mappings":"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"}

package/dist/src/lib/local-tools/ui/type-text.js

@@ -0,0 +1,40 @@
+import { ensureDomRagIndex } from "./dom-rag.js";
+export async function typeText(ctx, selectors, texts, clearFirst = true) {
+    const page = ctx.page;
+    if (!page) {
+        return { error: "Browser page not initialized" };
+    }
+    if (!Array.isArray(selectors) || !Array.isArray(texts) || selectors.length !== texts.length) {
+        return { error: "Selectors and texts arrays must be provided and match in length" };
+    }
+    if (selectors.length === 0) {
+        return { error: "No selectors provided" };
+    }
+    if (selectors.length > 6) {
+        return { error: "Maximum 6 inputs at a time" };
+    }
+    try {
+        for (let i = 0; i < selectors.length; i += 1) {
+            const selector = selectors[i];
+            const text = texts[i] ?? "";
+            if (clearFirst) {
+                await page.fill(selector, "");
+            }
+            await page.type(selector, text, { delay: 50 });
+        }
+        void (async () => {
+            try {
+                await page.waitForTimeout(200);
+                await ensureDomRagIndex(page);
+            }
+            catch {
+                /* best-effort */
+            }
+        })();
+        return { success: true, count: selectors.length };
+    }
+    catch (error) {
+        return { error: error?.message ?? String(error) };
+    }
+}
+//# sourceMappingURL=type-text.js.map

package/dist/src/lib/local-tools/ui/type-text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type-text.js","sourceRoot":"","sources":["../../../../../src/lib/local-tools/ui/type-text.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,iBAAiB,EAAC,MAAM,cAAc,CAAC;AAE/C,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,GAAwB,EACxB,SAAmB,EACnB,KAAe,EACf,aAAsB,IAAI;IAE1B,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,CAAC;IACtB,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAC,KAAK,EAAE,8BAA8B,EAAC,CAAC;IACjD,CAAC;IACD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,KAAK,CAAC,MAAM,EAAE,CAAC;QAC5F,OAAO,EAAC,KAAK,EAAE,iEAAiE,EAAC,CAAC;IACpF,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC3B,OAAO,EAAC,KAAK,EAAE,uBAAuB,EAAC,CAAC;IAC1C,CAAC;IACD,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACzB,OAAO,EAAC,KAAK,EAAE,4BAA4B,EAAC,CAAC;IAC/C,CAAC;IAED,IAAI,CAAC;QACH,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;YAC7C,MAAM,QAAQ,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;YAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;YAChC,CAAC;YACD,MAAM,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,IAAI,EAAE,EAAC,KAAK,EAAE,EAAE,EAAC,CAAC,CAAC;QAC/C,CAAC;QACD,KAAK,CAAC,KAAK,IAAI,EAAE;YACf,IAAI,CAAC;gBACH,MAAM,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC;gBAC/B,MAAM,iBAAiB,CAAC,IAAI,CAAC,CAAC;YAChC,CAAC;YAAC,MAAM,CAAC;gBACP,iBAAiB;YACnB,CAAC;QACH,CAAC,CAAC,EAAE,CAAC;QACL,OAAO,EAAC,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,CAAC,MAAM,EAAC,CAAC;IAClD,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,EAAC,KAAK,EAAE,KAAK,EAAE,OAAO,IAAI,MAAM,CAAC,KAAK,CAAC,EAAC,CAAC;IAClD,CAAC;AACH,CAAC"}

package/dist/src/lib/local-tools/ui/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/lib/local-tools/ui/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../src/lib/local-tools/ui/types.ts"],"names":[],"mappings":""}

package/dist/src/lib/local-tools/utility/finish-overall-test.js

@@ -0,0 +1,12 @@
+export async function finishOverallTest(summary) {
+    if (!summary || typeof summary !== "string") {
+        return { error: "summary is required" };
+    }
+    return {
+        success: true,
+        summary,
+        timestamp: Date.now(),
+        message: "Test session completed",
+    };
+}
+//# sourceMappingURL=finish-overall-test.js.map

package/dist/src/lib/local-tools/utility/finish-overall-test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"finish-overall-test.js","sourceRoot":"","sources":["../../../../../src/lib/local-tools/utility/finish-overall-test.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAe;IACrD,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,EAAE,CAAC;QAC5C,OAAO,EAAC,KAAK,EAAE,qBAAqB,EAAC,CAAC;IACxC,CAAC;IACD,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO;QACP,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE;QACrB,OAAO,EAAE,wBAAwB;KAClC,CAAC;AACJ,CAAC"}

package/dist/src/lib/local-tools/utility/index.js

@@ -0,0 +1,2 @@
+export { finishOverallTest } from "./finish-overall-test.js";
+//# sourceMappingURL=index.js.map

package/dist/src/lib/local-tools/utility/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/lib/local-tools/utility/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAC,iBAAiB,EAAC,MAAM,0BAA0B,CAAC"}

package/dist/src/lib/prompts/builder.js

@@ -0,0 +1,38 @@
+/**
+ * CLI Prompt Builder
+ * Builds system prompts for CLI agent reasoning
+ */
+import { CLI_AGENT_PROMPT_TEMPLATES } from "./templates.js";
+export function build_cli_system_prompt(prompt_type = "unified_agent_react", context = {}) {
+    const template = CLI_AGENT_PROMPT_TEMPLATES[prompt_type];
+    // Replace template variables
+    let prompt = template
+        .replace(/\{\{user_goal\}\}/g, context.user_goal || "unset")
+        .replace(/\{\{base_url\}\}/g, context.base_url || "unset")
+        .replace(/\{\{ui_base_url\}\}/g, context.ui_base_url || "unset")
+        .replace(/\{\{api_base_url\}\}/g, context.api_base_url || "unset")
+        .replace(/\{\{documentation_url\}\}/g, context.documentation_url || "unset")
+        .replace(/\{\{test_type\}\}/g, context.test_type || "mixed")
+        .replace(/\{\{mode\}\}/g, context.mode || "local");
+    // Add execution context footer
+    const exec_ctx_lines = [
+        "\n[Execution Context]",
+        `- base_url: ${context.base_url || "unset"}`,
+        `- test_type: ${context.test_type || "mixed"}`,
+        `- mode: ${context.mode || "local"}`,
+        "- Always resolve variables like base_url from context; never use the literal string 'base_url' in tool arguments.",
+        "- Local execution mode: You have direct access to the user's environment through tools.",
+        "- If testing API endpoints, prefer: api_discovery → discover_endpoints/search; then use api_request with explicit payloads based on documentation",
+    ];
+    const tail = "\n" + exec_ctx_lines.join("\n");
+    return prompt + tail;
+}
+export function get_cli_prompt_template(prompt_type) {
+    const valid_types = Object.keys(CLI_AGENT_PROMPT_TEMPLATES);
+    if (valid_types.includes(prompt_type)) {
+        return CLI_AGENT_PROMPT_TEMPLATES[prompt_type];
+    }
+    // Default to unified_agent_react
+    return CLI_AGENT_PROMPT_TEMPLATES.unified_agent_react;
+}
+//# sourceMappingURL=builder.js.map

package/dist/src/lib/prompts/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../../../../src/lib/prompts/builder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAC,0BAA0B,EAAgB,MAAM,gBAAgB,CAAC;AAYzE,MAAM,UAAU,uBAAuB,CACrC,cAA6B,qBAAqB,EAClD,UAA4B,EAAE;IAE9B,MAAM,QAAQ,GAAG,0BAA0B,CAAC,WAAW,CAAC,CAAC;IAEzD,6BAA6B;IAC7B,IAAI,MAAM,GAAG,QAAQ;SAClB,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC;SAC3D,OAAO,CAAC,mBAAmB,EAAE,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC;SACzD,OAAO,CAAC,sBAAsB,EAAE,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC;SAC/D,OAAO,CAAC,uBAAuB,EAAE,OAAO,CAAC,YAAY,IAAI,OAAO,CAAC;SACjE,OAAO,CAAC,4BAA4B,EAAE,OAAO,CAAC,iBAAiB,IAAI,OAAO,CAAC;SAC3E,OAAO,CAAC,oBAAoB,EAAE,OAAO,CAAC,SAAS,IAAI,OAAO,CAAC;SAC3D,OAAO,CAAC,eAAe,EAAE,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,CAAC;IAErD,+BAA+B;IAC/B,MAAM,cAAc,GAAG;QACrB,uBAAuB;QACvB,eAAe,OAAO,CAAC,QAAQ,IAAI,OAAO,EAAE;QAC5C,gBAAgB,OAAO,CAAC,SAAS,IAAI,OAAO,EAAE;QAC9C,WAAW,OAAO,CAAC,IAAI,IAAI,OAAO,EAAE;QACpC,mHAAmH;QACnH,yFAAyF;QACzF,mJAAmJ;KACpJ,CAAC;IAEF,MAAM,IAAI,GAAG,IAAI,GAAG,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAE9C,OAAO,MAAM,GAAG,IAAI,CAAC;AACvB,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,WAAmB;IACzD,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAC7B,0BAA0B,CACR,CAAC;IAErB,IAAI,WAAW,CAAC,QAAQ,CAAC,WAA4B,CAAC,EAAE,CAAC;QACvD,OAAO,0BAA0B,CAAC,WAA4B,CAAC,CAAC;IAClE,CAAC;IAED,iCAAiC;IACjC,OAAO,0BAA0B,CAAC,mBAAmB,CAAC;AACxD,CAAC"}

package/dist/src/lib/prompts/index.js

@@ -0,0 +1,7 @@
+/**
+ * CLI Prompts Module
+ * Exports prompt templates and builders for CLI agent reasoning
+ */
+export * from "./templates.js";
+export * from "./builder.js";
+//# sourceMappingURL=index.js.map

package/dist/src/lib/prompts/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/prompts/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,cAAc,CAAC"}

package/dist/src/lib/prompts/templates.js

@@ -0,0 +1,166 @@
+/**
+ * CLI Agent Prompt Templates
+ * Based on backend prompt patterns but adapted for CLI local execution
+ */
+export const CLI_AGENT_SYSTEM_PROMPT = `# 1. Core Identity & Mission
+
+You are TimetoTest CLI, a friendly and focused QA automation agent for local testing. You operate with precision, autonomy, and a clear intent in the terminal environment.
+
+Your mission is to achieve this user-defined goal:
+Goal: {{user_goal}}
+
+<guiding_principles>
+- Observe First, Act Second: Every action is informed by direct evidence from tool outputs. Never operate on assumptions.
+- Autonomy & Drive: Proactively move from one step to the next. Do not ask for permission. If blocked, record the issue, and move to the next task.
+- Clarity & Communication: Narrate your actions with brief, conversational notes for a non-technical audience. Your goal is to make the testing process transparent.
+- Security First: Never expose sensitive data, credentials, or internal system URLs in your communications.
+- Local Execution: You have direct access to the user's local environment through tools. Use this advantage to provide immediate, actionable results.
+</guiding_principles>
+
+# 2. The Four-Phase Testing Workflow
+
+Follow this structured process from start to finish.
+
+<phase_1_setup_discovery>
+- Start Browser Session: If you need to test UI, call browser_session(action="start") to launch a browser before using any UI tools. Do this only once if it was successfully started.
+</phase_1_setup_discovery>
+
+<phase_2_orientation_test_generation>
+- Navigate & Observe: Use browser_navigate to reach the target URL. The CLI will maintain a fresh accessibility snapshot automatically; consult it via browser_snapshot_query and add browser_take_screenshot when you need visual confirmation.
+- Validate Context: Before generating tests, ensure all necessary elements (e.g., login forms, buttons) are visible and ready.
+- Generate Test Cases: Once the context is validated, call generate_test_cases() to create test cases and add them to your todo list.
+</phase_2_orientation_test_generation>
+
+<phase_3_test_execution>
+- Iterate through each todo item until the list is empty.
+- For each test case, follow the Observe → Act → Verify loop.
+- Observe: Analyze the last screenshot to decide your next action.
+- Act: Use the Playwright MCP tools (browser_click, browser_type, browser_fill_form, browser_press_key, browser_select_option, api_request, etc.) to interact with the system.
+- Verify: Use browser_snapshot_query or examine API responses to confirm outcomes, and call browser_take_screenshot when you need visual evidence. Update the todo status (completed or failed).
+- Reset the application state between test cases as needed to ensure test independence.
+- Use reset_for_next_test_case tool to clear browser state, sign out users, and prepare for the next test case.
+- Retry bounds: Do not call the same tool with essentially identical inputs more than 3 times without progress. After three failed attempts, change strategy (different tool or approach) or record the blocker and move on.
+</phase_3_test_execution>
+
+<phase_4_completion_reporting>
+- Do not finish until all todo items are resolved (status is completed or failed).
+- Call finish_overall_test(summary) with a final report, including counts of completed vs. failed tests and key blockers.
+- End Browser Session: Call browser_session(action="stop") to clean up browser resources.
+- Finish Task: Call finish(summary) to stop the agent loop when the task is complete.
+</phase_4_completion_reporting>
+
+# 3. Rules of Engagement: Tools & Interaction
+
+<element_selection_strategy>
+Snapshot Cache: The CLI refreshes the accessibility snapshot after major UI actions. Query it with browser_snapshot_query using text and/or role filters to retrieve refs instead of capturing new snapshots yourself.
+Snapshot Query: Use browser_snapshot_query to look up refs by text or role from the cached snapshot. If the CLI reports the cache is stale, perform a new UI action (navigate, click, etc.) and it will refresh automatically.
+Interaction Rules:
+  - browser_click / browser_hover: supply element (human-friendly reasoning string) plus ref. Only add doubleClick/button/modifiers when necessary.
+  - browser_type: provide element, ref, and text. Use slowly or submit only when required. For multiple fields, prefer browser_fill_form with ordered field definitions.
+  - browser_select_option: provide element/ref and the list of option labels or values to select.
+  - browser_tabs manages windows, browser_handle_dialog clears blocking dialogs, browser_press_key issues global key strokes.
+Verification: After important actions, consult browser_snapshot_query or browser_take_screenshot (when visuals matter) to confirm the state before proceeding.
+Never invent refs or rely on CSS selectors. If you cannot find an element in the latest snapshot, explain the limitation, refresh the snapshot, or try an alternate path.
+</element_selection_strategy>
+
+<question_examples>
+- For single-element selection, use descriptive queries with 1-5 terms.
+- Examples for an email field:
+  - ["email"]
+Examples:
+- Snapshot snippet:
+  \`\`\`
+  - button "Sign in"
+    ref: 42
+  \`\`\`
+  Call browser_click with \`element="Sign in button"\` and \`ref="42"\`.
+- Input field snippet:
+  \`\`\`
+  - textbox "Email address"
+    ref: 17
+  \`\`\`
+  Use browser_type with \`element="Email address input"\`, \`ref="17"\`, and your desired text.
+- Multiple fields:
+  Provide an ordered array of \`{name, type, ref, value}\` objects to browser_fill_form, using the refs from the snapshot.
+- If a lookup fails, refresh the snapshot. If the ref still does not exist, acknowledge the blocker and continue.
+</question_examples>
+
+<observation_state_awareness>
+- Your world is the last screenshot or API response. Always reason about it before acting.
+- if you see a modal, dismiss it using "skip" or "close" buttons, visible in the screenshot.
+- Never take a screenshot of an empty or browser-internal page (like about:blank). Navigate to a real page first.
+- After an action, only take a new screenshot if you expect the UI to have changed.
+- For API testing, always validate responses and check status codes before proceeding.
+</observation_state_awareness>
+
+<input_credentials>
+- Never invent credentials, tokens, or other test data.
+- Use discovery tools and screenshots to understand how features work.
+- If you cannot find the required information through available tools, document the limitation and continue with reasonable assumptions.
+- When testing requires specific values that cannot be discovered, use placeholder values and document this in your test report.
+</input_credentials>
+
+# 4. Resilience & Knowledge
+
+<persistence_error_handling>
+- If a step fails, retry it up to two times, perhaps with a slightly different approach.
+- If still blocked, record a concise blocker note on the current todo, mark it failed, and move on to the next one.
+- Detect and break out of loops to avoid getting stuck.
+</persistence_error_handling>
+
+<tool_preambles>
+- For tool calls: add a brief, natural note only when useful. Vary phrasing, use present tense, and avoid repeating the same opener.
+  Examples: "Let me peek at the login page", "Interesting! I'll snap a screenshot to see what's happening", "Ah, looks like I need to click that Sign In button", "Just taking a quick look around", "Time to see what we're working with here".
+- Keep it friendly, concise, and co-worker conversational. Skip narration when the action is obvious.
+- Assume the audience is non-technical; prefer plain, direct language.
+- Add subtle personality touches: use "Let me...", "Time to...", "Interesting...", "Ah, I see...", "Just checking..." to sound more human and engaged.
+- At every step, actively remember what is currently on the screen (last screenshot) and use it to understand where you are before choosing the next action.
+</tool_preambles>
+
+<test_case_guidelines>
+- Each test case must be clear, concise, and easy to understand and end to end.
+- Use simple language without ambiguity; ensure intent is obvious to any reader.
+- Map each test case to a requirement, user story, or acceptance criterion.
+- Include clear preconditions, test steps, input data, and expected results.
+- Avoid assumptions—make the test executable without extra explanation.
+- Cover both positive (expected) and negative (invalid/boundary) scenarios when relevant.
+- Do not duplicate test cases for the same scenario unless necessary.
+- Prioritize critical, high-risk/high-impact areas first.
+</test_case_guidelines>
+
+<completion_criteria>
+- Do not finish until ALL todos are resolved. Before finishing, explicitly re-check the todo list and verify there are no items with status pending or in_progress.
+- A todo is resolved only if it is completed or failed with a concise blocker summary and evidence.
+- Reflect progress immediately in todo statuses after each step (start → in_progress, pass → completed, hard blocker after retries → failed).
+- Finish only after the todo list is fully resolved (no pending or in_progress items), then call finish_overall_test(summary) including counts of completed vs failed todos and top blockers.
+- If no tests were needed and no todos were created, finish_overall_test with a concise summary.
+- End early only if the user explicitly requests it; otherwise continue until the todo list is resolved.
+</completion_criteria>
+
+<authentication>
+- if you need to log out, use the reset_for_next_test_case tool to clear browser state.
+- Use reset_for_next_test_case tool to clear browser state or sign out users, or prepare for the next test case.
+- Do not attempt social login flows (e.g., Google, Apple, Facebook). If a task depends on them, state the limitation and move on.
+</authentication>
+
+<security_reliability>
+- Sanitize all inputs, handle dynamic content and SPA transitions, and maintain session awareness across tests.
+- Never reveal or output storage URLs (e.g., Cloudinary, S3, GCS, Azure Blob) in any message. If a screenshot or asset link exists, refer to it generically (e.g., "[screenshot available]") without the actual URL.
+- Redact any detected storage/CDN URLs in tool responses and summaries.
+- Never expose todo item IDs in any user-facing messages or summaries. Use descriptive names or references instead.
+- For local execution, be extra careful with file system access and network requests.
+</security_reliability>
+
+Context hints (may be unset):
+- Base URL: {{base_url}}
+- UI base URL: {{ui_base_url}}
+- API base URL: {{api_base_url}}
+- Documentation URL: {{documentation_url}}
+- Test Type: {{test_type}}
+- Mode: {{mode}} (local execution with direct access to user's environment)`;
+export const CLI_AGENT_PROMPT_TEMPLATES = {
+    unified_agent_react: CLI_AGENT_SYSTEM_PROMPT,
+    ui_agent_react: CLI_AGENT_SYSTEM_PROMPT,
+    api_agent_react: CLI_AGENT_SYSTEM_PROMPT,
+};
+//# sourceMappingURL=templates.js.map

package/dist/src/lib/prompts/templates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"templates.js","sourceRoot":"","sources":["../../../../src/lib/prompts/templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,CAAC,MAAM,uBAAuB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;4EA2JqC,CAAC;AAE7E,MAAM,CAAC,MAAM,0BAA0B,GAAG;IACxC,mBAAmB,EAAE,uBAAuB;IAC5C,cAAc,EAAE,uBAAuB;IACvC,eAAe,EAAE,uBAAuB;CAChC,CAAC"}

package/dist/src/lib/session-manager.js

@@ -0,0 +1,201 @@
+/**
+ * Session Manager - Conversation and artifact persistence
+ * Stores chat history, tool outputs, and test artifacts locally
+ */
+import * as fs from "fs";
+import * as path from "path";
+import { homedir } from "os";
+import { randomUUID } from "crypto";
+const SESSIONS_DIR = path.join(homedir(), ".timetotest", "sessions");
+export class SessionManager {
+    sessionId;
+    sessionPath;
+    session = null;
+    constructor(sessionId) {
+        this.sessionId = sessionId || randomUUID();
+        this.sessionPath = path.join(SESSIONS_DIR, this.sessionId);
+        this.initializeSession();
+    }
+    initializeSession() {
+        if (!fs.existsSync(SESSIONS_DIR)) {
+            fs.mkdirSync(SESSIONS_DIR, { recursive: true });
+        }
+        if (!fs.existsSync(this.sessionPath)) {
+            fs.mkdirSync(this.sessionPath, { recursive: true });
+        }
+        const configPath = path.join(this.sessionPath, "config.json");
+        if (fs.existsSync(configPath)) {
+            const config = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+            this.session = {
+                config,
+                messages: this.loadMessages(),
+                artifacts: this.loadArtifacts(),
+            };
+        }
+        else {
+            this.session = {
+                config: {
+                    id: this.sessionId,
+                    mode: "local",
+                    testingMode: "ui",
+                    createdAt: Date.now(),
+                    updatedAt: Date.now(),
+                },
+                messages: [],
+                artifacts: {},
+            };
+            this.saveConfig();
+        }
+    }
+    saveConfig() {
+        if (!this.session)
+            return;
+        const configPath = path.join(this.sessionPath, "config.json");
+        fs.writeFileSync(configPath, JSON.stringify(this.session.config, null, 2), "utf-8");
+    }
+    loadMessages() {
+        const messagesPath = path.join(this.sessionPath, "messages.json");
+        if (fs.existsSync(messagesPath)) {
+            return JSON.parse(fs.readFileSync(messagesPath, "utf-8"));
+        }
+        return [];
+    }
+    loadArtifacts() {
+        const artifactsPath = path.join(this.sessionPath, "artifacts.json");
+        if (fs.existsSync(artifactsPath)) {
+            return JSON.parse(fs.readFileSync(artifactsPath, "utf-8"));
+        }
+        return {};
+    }
+    addMessage(message) {
+        if (!this.session)
+            return;
+        if (!message.timestamp) {
+            message.timestamp = Date.now();
+        }
+        this.session.messages.push(message);
+        this.session.config.updatedAt = Date.now();
+        this.saveMessages();
+        this.saveConfig();
+    }
+    clearMessages() {
+        if (!this.session)
+            return;
+        this.session.messages = [];
+        this.session.config.updatedAt = Date.now();
+        this.saveMessages();
+        this.saveConfig();
+    }
+    saveMessages() {
+        if (!this.session)
+            return;
+        const messagesPath = path.join(this.sessionPath, "messages.json");
+        fs.writeFileSync(messagesPath, JSON.stringify(this.session.messages, null, 2), "utf-8");
+    }
+    saveArtifact(name, data) {
+        if (!this.session)
+            return;
+        this.session.artifacts[name] = {
+            data,
+            savedAt: Date.now(),
+        };
+        this.session.config.updatedAt = Date.now();
+        this.saveArtifacts();
+        this.saveConfig();
+    }
+    saveArtifacts() {
+        if (!this.session)
+            return;
+        const artifactsPath = path.join(this.sessionPath, "artifacts.json");
+        fs.writeFileSync(artifactsPath, JSON.stringify(this.session.artifacts, null, 2), "utf-8");
+    }
+    saveScreenshot(filename, buffer) {
+        if (!this.session)
+            return;
+        const screenshotsDir = path.join(this.sessionPath, "screenshots");
+        if (!fs.existsSync(screenshotsDir)) {
+            fs.mkdirSync(screenshotsDir, { recursive: true });
+        }
+        fs.writeFileSync(path.join(screenshotsDir, filename), buffer);
+        this.session.artifacts[`screenshot:${filename}`] = {
+            type: "screenshot",
+            path: `screenshots/${filename}`,
+            savedAt: Date.now(),
+        };
+        this.saveArtifacts();
+    }
+    saveDocument(filename, content, type = "document") {
+        if (!this.session)
+            return;
+        this.session.artifacts[`${type}:${filename}`] = {
+            type,
+            content,
+            savedAt: Date.now(),
+        };
+        this.saveArtifacts();
+    }
+    getMessages() {
+        return this.session?.messages || [];
+    }
+    getArtifacts() {
+        return this.session?.artifacts || {};
+    }
+    getConfig() {
+        return this.session?.config || null;
+    }
+    updateConfig(updates) {
+        if (!this.session)
+            return;
+        this.session.config = {
+            ...this.session.config,
+            ...updates,
+            updatedAt: Date.now(),
+        };
+        this.saveConfig();
+    }
+    getSessionId() {
+        return this.sessionId;
+    }
+    getSessionPath() {
+        return this.sessionPath;
+    }
+    static listSessions() {
+        if (!fs.existsSync(SESSIONS_DIR)) {
+            return [];
+        }
+        const sessions = [];
+        const dirs = fs.readdirSync(SESSIONS_DIR);
+        for (const dir of dirs) {
+            const configPath = path.join(SESSIONS_DIR, dir, "config.json");
+            if (fs.existsSync(configPath)) {
+                const config = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+                sessions.push(config);
+            }
+        }
+        return sessions.sort((a, b) => b.updatedAt - a.updatedAt);
+    }
+    static clearSession(sessionId) {
+        const sessionPath = path.join(SESSIONS_DIR, sessionId);
+        if (fs.existsSync(sessionPath)) {
+            fs.rmSync(sessionPath, { recursive: true });
+        }
+    }
+    static deleteOldSessions(retentionDays = 7) {
+        if (!fs.existsSync(SESSIONS_DIR)) {
+            return;
+        }
+        const now = Date.now();
+        const retentionMs = retentionDays * 24 * 60 * 60 * 1000;
+        const dirs = fs.readdirSync(SESSIONS_DIR);
+        for (const dir of dirs) {
+            const configPath = path.join(SESSIONS_DIR, dir, "config.json");
+            if (fs.existsSync(configPath)) {
+                const config = JSON.parse(fs.readFileSync(configPath, "utf-8"));
+                if (now - config.updatedAt > retentionMs) {
+                    fs.rmSync(path.join(SESSIONS_DIR, dir), { recursive: true });
+                }
+            }
+        }
+    }
+}
+//# sourceMappingURL=session-manager.js.map