@jackwener/opencli 1.7.12 → 1.7.14

package/clis/chatwise/send.js

@@ -1,5 +1,6 @@
 import { cli, Strategy } from '@jackwener/opencli/registry';
 import { selectorError } from '@jackwener/opencli/errors';
+import { buildChatwiseInjectTextJs } from './utils.js';
 export const sendCommand = cli({
     site: 'chatwise',
     name: 'send',
@@ -12,30 +13,7 @@ export const sendCommand = cli({
     columns: ['Status', 'InjectedText'],
     func: async (page, kwargs) => {
         const text = kwargs.text;
-        const injected = await page.evaluate(`
-      (function(text) {
-        // ChatWise input can be textarea or contenteditable
-        let composer = document.querySelector('textarea');
-        if (!composer) {
-          const editables = Array.from(document.querySelectorAll('[contenteditable="true"]'));
-          composer = editables.length > 0 ? editables[editables.length - 1] : null;
-        }
-
-        if (!composer) return false;
-
-        composer.focus();
-        
-        if (composer.tagName === 'TEXTAREA') {
-          // For textarea, set value and dispatch input event
-          const nativeInputValueSetter = Object.getOwnPropertyDescriptor(window.HTMLTextAreaElement.prototype, 'value').set;
-          nativeInputValueSetter.call(composer, text);
-          composer.dispatchEvent(new Event('input', { bubbles: true }));
-        } else {
-          document.execCommand('insertText', false, text);
-        }
-        return true;
-      })(${JSON.stringify(text)})
-    `);
+        const injected = await page.evaluate(buildChatwiseInjectTextJs(text));
         if (!injected)
             throw selectorError('ChatWise input element');
         await page.wait(0.5);

package/clis/chatwise/utils.js

@@ -0,0 +1,143 @@
+import { ArgumentError } from '@jackwener/opencli/errors';
+
+export const MESSAGE_WRAPPER_SELECTOR = '[class*="group/message"]';
+export const MIN_COMPOSER_SCORE = 120;
+
+export function requirePositiveTimeout(value) {
+    const timeout = value;
+    if (!Number.isInteger(timeout) || timeout <= 0) {
+        throw new ArgumentError('--timeout must be a positive integer (seconds)');
+    }
+    return timeout;
+}
+
+export function scoreChatwiseComposerCandidate(candidate, viewportHeight = 0) {
+    if (candidate.hidden) return -1000;
+
+    let score = 0;
+    const normalizedRole = String(candidate.role || '').toLowerCase();
+    if (normalizedRole === 'textbox') score += 10;
+
+    const normalizedClasses = `${candidate.classes || ''} ${candidate.editorClasses || ''} ${candidate.ariaLabel || ''}`.toLowerCase();
+    if (normalizedClasses.includes('cm-content')) score += 20;
+    if (normalizedClasses.includes('cm-editor')) score += 30;
+    if (normalizedClasses.includes('simple-editor')) score -= 140;
+
+    const searchableText = `${candidate.placeholder || ''} ${candidate.ariaLabel || ''} ${candidate.text || ''}`.toLowerCase();
+    if (searchableText.includes('enter a message here')) score += 220;
+    if (searchableText.includes('press ⏎ to send')) score += 80;
+    if (searchableText.includes('press enter to send')) score += 80;
+    if (searchableText.includes('message')) score += 20;
+    if (searchableText.includes('optional description')) score -= 140;
+    if (searchableText.includes('user context document')) score -= 220;
+
+    if (viewportHeight > 0 && candidate.rect) {
+        const bottom = candidate.rect.y + candidate.rect.h;
+        const distanceFromBottom = Math.abs(viewportHeight - bottom);
+        score += Math.max(0, 80 - distanceFromBottom / 8);
+    }
+
+    return score;
+}
+
+export function selectBestChatwiseComposer(candidates, viewportHeight = 0, minScore = MIN_COMPOSER_SCORE) {
+    if (!Array.isArray(candidates) || candidates.length === 0) return null;
+    const best = [...candidates]
+        .sort((left, right) => {
+            const delta = scoreChatwiseComposerCandidate(right, viewportHeight)
+                - scoreChatwiseComposerCandidate(left, viewportHeight);
+            return delta !== 0 ? delta : left.index - right.index;
+        })[0] ?? null;
+    if (!best || scoreChatwiseComposerCandidate(best, viewportHeight) < minScore) return null;
+    return best;
+}
+
+export function buildChatwiseInjectTextJs(text) {
+    const scoreFn = scoreChatwiseComposerCandidate.toString();
+    const selectFn = selectBestChatwiseComposer.toString();
+    const textJs = JSON.stringify(String(text ?? ''));
+
+    return `
+      (function(text) {
+        const scoreChatwiseComposerCandidate = ${scoreFn};
+        const selectBestChatwiseComposer = ${selectFn};
+        const MIN_COMPOSER_SCORE = ${MIN_COMPOSER_SCORE};
+
+        const composers = Array.from(document.querySelectorAll([
+          'textarea[aria-label*="message" i]',
+          'textarea[placeholder*="message" i]',
+          '[contenteditable="true"][role="textbox"]',
+          '[contenteditable="true"]'
+        ].join(',')));
+        const candidates = composers.map((el, index) => {
+          const rect = el.getBoundingClientRect();
+          const editor = el.closest('.cm-editor');
+          const placeholderEl = editor?.querySelector('.cm-placeholder');
+          return {
+            index,
+            hidden: !(el.offsetWidth || el.offsetHeight || el.getClientRects().length),
+            role: el.getAttribute('role'),
+            classes: el.className || '',
+            editorClasses: editor?.className || '',
+            ariaLabel: el.getAttribute('aria-label') || '',
+            placeholder: placeholderEl?.getAttribute('aria-label') || placeholderEl?.textContent || el.getAttribute('placeholder') || '',
+            text: (el.textContent || '').trim(),
+            rect: { y: rect.y, h: rect.height },
+          };
+        });
+
+        const best = selectBestChatwiseComposer(candidates, window.innerHeight, MIN_COMPOSER_SCORE);
+        if (!best) return false;
+
+        const composer = composers[best.index];
+        composer.focus();
+
+        if (composer.tagName === 'TEXTAREA') {
+          const setter = Object.getOwnPropertyDescriptor(window.HTMLTextAreaElement.prototype, 'value')?.set;
+          if (setter) setter.call(composer, text);
+          else composer.value = text;
+          composer.dispatchEvent(new Event('input', { bubbles: true }));
+          return true;
+        }
+
+        const selection = window.getSelection();
+        const range = document.createRange();
+        range.selectNodeContents(composer);
+        selection?.removeAllRanges();
+        selection?.addRange(range);
+
+        const inserted = document.execCommand?.('insertText', false, text);
+        if (!inserted) {
+          composer.textContent = text;
+        }
+        composer.dispatchEvent(new Event('input', { bubbles: true }));
+        return true;
+      })(${textJs})
+    `;
+}
+
+export function buildChatwiseMessageCountJs() {
+    return `
+      (function() {
+        return Array.from(document.querySelectorAll(${JSON.stringify(MESSAGE_WRAPPER_SELECTOR)}))
+          .map(node => (node.innerText || node.textContent || '').trim())
+          .filter(Boolean)
+          .length;
+      })()
+    `;
+}
+
+export function buildChatwiseResponseAfterJs(previousCount, userText) {
+    return `
+      (function(previousCount, userText) {
+        const messages = Array.from(document.querySelectorAll(${JSON.stringify(MESSAGE_WRAPPER_SELECTOR)}))
+          .map(node => (node.innerText || node.textContent || '').trim())
+          .filter(Boolean);
+        if (messages.length <= previousCount) return null;
+        const fresh = messages.slice(previousCount)
+          .filter(text => text && text !== userText);
+        if (fresh.length === 0) return null;
+        return fresh[fresh.length - 1];
+      })(${Number(previousCount) || 0}, ${JSON.stringify(String(userText ?? ''))})
+    `;
+}

package/clis/claude/ask.js

@@ -14,8 +14,8 @@ export const askCommand = cli({
     domain: CLAUDE_DOMAIN,
     strategy: Strategy.COOKIE,
     browser: true,
+    browserSession: { reuse: 'site' },
     navigateBefore: false,
-    timeoutSeconds: 180,
     args: [
         { name: 'prompt', positional: true, required: true, help: 'Prompt to send' },
         { name: 'timeout', type: 'int', default: 120, help: 'Max seconds to wait for response' },

package/clis/claude/detail.js

@@ -10,6 +10,7 @@ export const detailCommand = cli({
     domain: CLAUDE_DOMAIN,
     strategy: Strategy.COOKIE,
     browser: true,
+    browserSession: { reuse: 'site' },
     navigateBefore: false,
     args: [
         { name: 'id', positional: true, required: true, help: 'Conversation ID (UUID from /chat/<id>)' },

package/clis/claude/history.js

@@ -10,6 +10,7 @@ export const historyCommand = cli({
     domain: CLAUDE_DOMAIN,
     strategy: Strategy.COOKIE,
     browser: true,
+    browserSession: { reuse: 'site' },
     navigateBefore: false,
     args: [
         { name: 'limit', type: 'int', default: 20, help: 'Max conversations to show' },

package/clis/claude/new.js

@@ -9,6 +9,7 @@ export const newCommand = cli({
     domain: CLAUDE_DOMAIN,
     strategy: Strategy.COOKIE,
     browser: true,
+    browserSession: { reuse: 'site' },
     navigateBefore: false,
     args: [],
     columns: ['Status'],

package/clis/claude/read.js

@@ -10,6 +10,7 @@ export const readCommand = cli({
     domain: CLAUDE_DOMAIN,
     strategy: Strategy.COOKIE,
     browser: true,
+    browserSession: { reuse: 'site' },
     navigateBefore: false,
     args: [],
     columns: ['Index', 'Role', 'Text'],

package/clis/claude/send.js

@@ -10,6 +10,7 @@ export const sendCommand = cli({
     domain: CLAUDE_DOMAIN,
     strategy: Strategy.COOKIE,
     browser: true,
+    browserSession: { reuse: 'site' },
     navigateBefore: false,
     args: [
         { name: 'prompt', positional: true, required: true, help: 'Prompt to send' },

package/clis/claude/status.js

@@ -9,6 +9,7 @@ export const statusCommand = cli({
     domain: CLAUDE_DOMAIN,
     strategy: Strategy.COOKIE,
     browser: true,
+    browserSession: { reuse: 'site' },
     navigateBefore: false,
     args: [],
     columns: ['Status', 'Login', 'Url'],

package/clis/codex/ask.js

@@ -1,21 +1,27 @@
 import { cli, Strategy } from '@jackwener/opencli/registry';
-import { selectorError } from '@jackwener/opencli/errors';
+import { ArgumentError, selectorError } from '@jackwener/opencli/errors';
+import { conversationSelectionArgs, openCodexConversation } from './sidebar.js';
 export const askCommand = cli({
     site: 'codex',
     name: 'ask',
     access: 'write',
-    description: 'Send a prompt and wait for the AI response (send + wait + read)',
+    description: 'Send a prompt to the current or selected Codex conversation and wait for the AI response',
     domain: 'localhost',
     strategy: Strategy.UI,
     browser: true,
     args: [
         { name: 'text', required: true, positional: true, help: 'Prompt to send' },
-        { name: 'timeout', required: false, help: 'Max seconds to wait for response (default: 60)', default: '60' },
+        { name: 'timeout', type: 'int', required: false, help: 'Max seconds to wait for response (default: 60)', default: 60 },
+        ...conversationSelectionArgs,
     ],
-    columns: ['Role', 'Text'],
+    columns: ['Role', 'Project', 'Conversation', 'Text'],
     func: async (page, kwargs) => {
         const text = kwargs.text;
-        const timeout = parseInt(kwargs.timeout, 10) || 60;
+        const timeout = kwargs.timeout;
+        if (!Number.isInteger(timeout) || timeout < 1) {
+            throw new ArgumentError('--timeout must be a positive integer (seconds)');
+        }
+        const selected = await openCodexConversation(page, kwargs);
         // Snapshot the current content length before sending
         const beforeLen = await page.evaluate(`
       (function() {
@@ -60,13 +66,13 @@ export const askCommand = cli({
         }
         if (!response) {
             return [
-                { Role: 'User', Text: text },
-                { Role: 'System', Text: `No response within ${timeout}s. The agent may still be working.` },
+                { Role: 'User', Project: selected?.project || '', Conversation: selected?.conversation || '', Text: text },
+                { Role: 'System', Project: selected?.project || '', Conversation: selected?.conversation || '', Text: `No response within ${timeout}s. The agent may still be working.` },
             ];
         }
         return [
-            { Role: 'User', Text: text },
-            { Role: 'Assistant', Text: response },
+            { Role: 'User', Project: selected?.project || '', Conversation: selected?.conversation || '', Text: text },
+            { Role: 'Assistant', Project: selected?.project || '', Conversation: selected?.conversation || '', Text: response },
         ];
     },
 });

package/clis/codex/history.js

@@ -1,44 +1,27 @@
 import { cli, Strategy } from '@jackwener/opencli/registry';
+import { EmptyResultError } from '@jackwener/opencli/errors';
+import { flattenCodexProjects, readCodexProjects } from './sidebar.js';
 export const historyCommand = cli({
     site: 'codex',
     name: 'history',
     access: 'read',
-    description: 'List recent conversation threads in Codex',
+    description: 'List visible Codex conversation threads grouped by project',
     domain: 'localhost',
     strategy: Strategy.UI,
     browser: true,
-    args: [],
-    columns: ['Index', 'Title'],
-    func: async (page) => {
-        const items = await page.evaluate(`
-      (function() {
-        const results = [];
-        // Codex thread list items
-        const entries = document.querySelectorAll('[data-testid*="thread"], [class*="thread-list"] a, [role="listbox"] [role="option"]');
-        
-        entries.forEach((item, i) => {
-          const title = (item.textContent || item.innerText || '').trim().substring(0, 100);
-          if (title) results.push({ Index: i + 1, Title: title });
-        });
-        
-        // Fallback: sidebar/nav links
-        if (results.length === 0) {
-          const nav = document.querySelector('nav, [role="navigation"], aside');
-          if (nav) {
-            const links = nav.querySelectorAll('a, button');
-            links.forEach((link, i) => {
-              const text = (link.textContent || '').trim().substring(0, 100);
-              if (text && text.length > 3) results.push({ Index: i + 1, Title: text });
-            });
-          }
+    args: [
+        { name: 'project', required: false, help: 'Filter by project label or path' },
+        { name: 'limit', required: false, help: 'Max conversations per project' },
+    ],
+    columns: ['Project', 'Index', 'Title', 'Updated', 'Active'],
+    func: async (page, kwargs) => {
+        const projects = await readCodexProjects(page);
+        const rows = flattenCodexProjects(projects, kwargs);
+        if (rows.length === 0) {
+            throw new EmptyResultError('codex history', kwargs.project
+                ? `No Codex conversations were visible for project "${kwargs.project}".`
+                : 'No Codex conversations were visible. Open the Codex sidebar and retry.');
         }
-        
-        return results;
-      })()
-    `);
-        if (items.length === 0) {
-            return [{ Index: 0, Title: 'No threads found. Try opening the thread list first.' }];
-        }
-        return items;
+        return rows;
     },
 });

package/clis/codex/projects.js

@@ -0,0 +1,28 @@
+import { cli, Strategy } from '@jackwener/opencli/registry';
+import { EmptyResultError } from '@jackwener/opencli/errors';
+import { flattenCodexProjects, readCodexProjects } from './sidebar.js';
+
+export const projectsCommand = cli({
+    site: 'codex',
+    name: 'projects',
+    access: 'read',
+    description: 'List Codex projects and visible conversations from the sidebar',
+    domain: 'localhost',
+    strategy: Strategy.UI,
+    browser: true,
+    args: [
+        { name: 'project', required: false, help: 'Filter by project label or path' },
+        { name: 'limit', required: false, help: 'Max conversations per project' },
+    ],
+    columns: ['Project', 'Index', 'Title', 'Updated', 'Active'],
+    func: async (page, kwargs) => {
+        const projects = await readCodexProjects(page);
+        const rows = flattenCodexProjects(projects, kwargs);
+        if (rows.length === 0) {
+            throw new EmptyResultError('codex projects', kwargs.project
+                ? `No Codex projects matched "${kwargs.project}".`
+                : 'No Codex projects were visible. Open the Codex sidebar and retry.');
+        }
+        return rows;
+    },
+});

package/clis/codex/read.js

@@ -1,15 +1,19 @@
 import { cli, Strategy } from '@jackwener/opencli/registry';
+import { conversationSelectionArgs, openCodexConversation } from './sidebar.js';
 export const readCommand = cli({
     site: 'codex',
     name: 'read',
     access: 'read',
-    description: 'Read the contents of the current Codex conversation thread',
+    description: 'Read the contents of the current or selected Codex conversation thread',
     domain: 'localhost',
     strategy: Strategy.UI,
     browser: true,
-    args: [],
-    columns: ['Content'],
-    func: async (page) => {
+    args: [
+        ...conversationSelectionArgs,
+    ],
+    columns: ['Project', 'Conversation', 'Content'],
+    func: async (page, kwargs) => {
+        const selected = await openCodexConversation(page, kwargs);
         const historyText = await page.evaluate(`
       (function() {
         const turns = Array.from(document.querySelectorAll('[data-content-search-turn-key]'));
@@ -28,6 +32,8 @@ export const readCommand = cli({
     `);
         return [
             {
+                Project: selected?.project || '',
+                Conversation: selected?.conversation || '',
                 Content: historyText,
             },
         ];

package/clis/codex/send.js

@@ -1,17 +1,22 @@
 import { cli, Strategy } from '@jackwener/opencli/registry';
 import { selectorError } from '@jackwener/opencli/errors';
+import { conversationSelectionArgs, openCodexConversation } from './sidebar.js';
 export const sendCommand = cli({
     site: 'codex',
     name: 'send',
     access: 'write',
-    description: 'Send text/commands to the Codex AI composer',
+    description: 'Send text/commands to the current or selected Codex AI composer',
     domain: 'localhost',
     strategy: Strategy.UI,
     browser: true,
-    args: [{ name: 'text', required: true, positional: true, help: 'Text, command (e.g. /review), or skill (e.g. $imagegen)' }],
-    columns: ['Status', 'InjectedText'],
+    args: [
+        { name: 'text', required: true, positional: true, help: 'Text, command (e.g. /review), or skill (e.g. $imagegen)' },
+        ...conversationSelectionArgs,
+    ],
+    columns: ['Status', 'Project', 'Conversation', 'InjectedText'],
     func: async (page, kwargs) => {
         const textToInsert = kwargs.text;
+        const selected = await openCodexConversation(page, kwargs);
         const injected = await page.evaluate(`
       (function(text) {
         let composer = document.querySelector('textarea, [contenteditable="true"]');
@@ -37,6 +42,8 @@ export const sendCommand = cli({
         return [
             {
                 Status: 'Success',
+                Project: selected?.project || '',
+                Conversation: selected?.conversation || '',
                 InjectedText: textToInsert,
             },
         ];