taskuary 0.3.1__tar.gz → 0.3.2__tar.gz

taskuary-0.3.2/PKG-INFO

@@ -0,0 +1,165 @@
+Metadata-Version: 2.4
+Name: taskuary
+Version: 0.3.2
+Summary: Automate your job - the local-first operating system for your work: AI triage in, coding agents out.
+License: MIT
+Project-URL: Homepage, https://github.com/ldbumble/taskuary
+Project-URL: Repository, https://github.com/ldbumble/taskuary
+Project-URL: Issues, https://github.com/ldbumble/taskuary/issues
+Project-URL: Changelog, https://github.com/ldbumble/taskuary/releases
+Keywords: ai,agents,automation,claude,coding-agent,email,local-first,task-management
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business :: Scheduling
+Classifier: Topic :: Software Development :: Build Tools
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: fastapi>=0.100
+Requires-Dist: uvicorn>=0.23
+Requires-Dist: pydantic>=2
+Requires-Dist: requests>=2.28
+Requires-Dist: loguru>=0.7
+Requires-Dist: segno>=1.6
+Requires-Dist: anthropic>=0.69
+Requires-Dist: tomli>=2; python_version < "3.11"
+Requires-Dist: websockets>=12
+Requires-Dist: pywinpty>=2; sys_platform == "win32"
+Requires-Dist: pyte>=0.8
+Provides-Extra: mssql
+Requires-Dist: pyodbc>=4; extra == "mssql"
+Provides-Extra: db
+Requires-Dist: sqlalchemy>=2; extra == "db"
+Provides-Extra: aws
+Requires-Dist: boto3>=1.28; extra == "aws"
+Provides-Extra: voice
+Requires-Dist: faster-whisper>=1.0; extra == "voice"
+Provides-Extra: desktop
+Requires-Dist: pywebview>=4; extra == "desktop"
+Provides-Extra: build
+Requires-Dist: pyinstaller>=6; extra == "build"
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+Requires-Dist: httpx>=0.24; extra == "dev"
+Requires-Dist: openpyxl>=3; extra == "dev"
+Dynamic: license-file
+
+# Taskuary
+
+[![CI](https://github.com/ldbumble/taskuary/actions/workflows/ci.yml/badge.svg)](https://github.com/ldbumble/taskuary/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/taskuary.svg)](https://pypi.org/project/taskuary/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-3776ab.svg)](https://github.com/ldbumble/taskuary)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+## Your inbox, staffed by AI agents.
+
+Taskuary brings your mail, chats, issues, and scheduled reports onto one local timeline.
+AI triage decides what is real work, your coding CLI works the tasks in your own repos,
+and replies wait for your approval. Nothing sends or ships without you.
+
+![The Taskuary Studio: work arrives, triage decides what needs action, and agents take seats to work it.](https://raw.githubusercontent.com/ldbumble/taskuary/master/docs/hero.gif)
+
+Taskuary is early—currently **v0.3.2**—and moving fast. The funnel, review queue,
+agent sessions, and reports pipeline are in daily use; breaking changes are still possible
+before 1.0.
+
+## One timeline for incoming work
+
+Outlook, Gmail, Teams, Slack, Telegram, WhatsApp, GitHub, Jira, alerts, and reports all
+arrive on the same day-grouped rail. Each row says what it is and whether it needs you.
+Open one to see the full message, its attachments, why triage ruled that way, the drafted
+reply, and every available next step.
+
+![The Timeline with mail, chats, reports, active tasks, and an Assistant post on one rail.](https://raw.githubusercontent.com/ldbumble/taskuary/master/docs/screenshot-timeline-crop.png)
+
+Coding work can go straight to Claude Code, Codex, Gemini, Cursor, Copilot, or any CLI that
+accepts a prompt on stdin. You watch the live terminal, answer questions, review the diff,
+and approve what happens next. Research, marketing, and other general work belong in a
+conversational workspace built with assistant-ui and your existing Taskuary AI connections.
+Assistant and terminal are two views of the same session: model, history, queued instructions,
+image attachments, and the side-by-side browser stay put when you switch. The same workspace
+also appears on the Wall.
+
+## An assistant that notices what falls between tasks
+
+The Assistant periodically reads what the hub can see and posts only when it has something
+useful to say: a reply that went unanswered, a meeting that needs context, a task that went
+quiet, or a pattern across the week's work. Every suggestion includes its evidence and can
+be made into a task, dismissed, snoozed, or taught away with **Not this**.
+
+![An Assistant post showing two evidence-backed suggestions and what it reviewed.](https://raw.githubusercontent.com/ldbumble/taskuary/master/docs/screenshot-assistant.png)
+
+It watches the systems you run on, not only the hub. Point it at a Sage Intacct query, a
+database, a file, a REST or MCP tool, a cloud log group, or an agent skill—no saved report has
+to stand behind any of them—and it reads each one silently on every check. That step would
+otherwise ask you to know an object name and a list of field ids, so you can describe what it
+should keep an eye on instead and the AI writes the source cards: it may only choose systems you
+have actually connected, it reads the real schema before writing a query, and it asks rather
+than guessing a filter. The same help sits on every source card in the report builder.
+
+Its voice, schedule, model, and thresholds are yours to change. It leaves a note for its next
+check, does not repeat itself, and stays silent when there is nothing worth interrupting you
+for.
+
+## Install
+
+### Windows app
+
+Download the latest single-file
+[Taskuary.exe](https://github.com/ldbumble/taskuary/releases/latest/download/Taskuary.exe)
+and open it. No Python or installer is required.
+
+### Python
+
+Python 3.10 or newer works on Windows, macOS, and Linux:
+
+```bash
+pip install taskuary
+taskuary
+```
+
+Taskuary opens at [http://127.0.0.1:7787](http://127.0.0.1:7787). For a native desktop
+window instead, install `pip install "taskuary[desktop]"` and run `taskuary-desktop`.
+
+### Docker
+
+```bash
+git clone https://github.com/ldbumble/taskuary
+cd taskuary
+docker compose up
+```
+
+Then open [http://127.0.0.1:7787](http://127.0.0.1:7787). Docker runs the web app;
+coding CLIs and the optional WhatsApp bridge remain on the host.
+
+On first run, connect an AI provider or local Ollama model, add at least one inbound
+channel, then choose the coding CLI that should receive tasks. The setup wizards test each
+connection before it goes live.
+
+## Installs
+
+![Daily installs of taskuary from PyPI, mirror traffic excluded](https://raw.githubusercontent.com/ldbumble/taskuary/master/docs/downloads.svg)
+
+Redrawn every morning by [`downloads.yml`](.github/workflows/downloads.yml) from PyPI's own
+numbers, with mirror traffic excluded — a full PyPI mirror pulls every release, so counting it
+would let a handful of real users read as hundreds. What it does **not** claim is that CI
+installs have been removed: the field that would separate `pip install` in a build runner from
+one on somebody's laptop is in PyPI's BigQuery dataset, not in the public API. The daily series
+is [docs/downloads.csv](docs/downloads.csv).
+
+## Documentation
+
+- [Getting started](docs/getting-started.md)—installation, first-run setup, Docker, and data
+- [Product guide](docs/product-guide.md)—the workflow, learning loop, agents, and operator documents
+- [Integrations](docs/integrations.md)—channels, AI providers, work systems, and report sources
+- [Reports and the Assistant](docs/reports-and-assistant.md)—the report pipeline, letting the AI write the source cards, and what the Assistant watches
+- [Status and roadmap](docs/roadmap.md)—what works today and what is next
+- [Contributing](CONTRIBUTING.md)—development setup and contribution guide
+
+Taskuary is free and open source under the [MIT License](LICENSE). Issues and pull requests
+are welcome; security reports belong in [SECURITY.md](SECURITY.md).

taskuary-0.3.2/README.md

@@ -0,0 +1,114 @@
+# Taskuary
+
+[![CI](https://github.com/ldbumble/taskuary/actions/workflows/ci.yml/badge.svg)](https://github.com/ldbumble/taskuary/actions/workflows/ci.yml)
+[![PyPI](https://img.shields.io/pypi/v/taskuary.svg)](https://pypi.org/project/taskuary/)
+[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-3776ab.svg)](https://github.com/ldbumble/taskuary)
+[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+## Your inbox, staffed by AI agents.
+
+Taskuary brings your mail, chats, issues, and scheduled reports onto one local timeline.
+AI triage decides what is real work, your coding CLI works the tasks in your own repos,
+and replies wait for your approval. Nothing sends or ships without you.
+
+![The Taskuary Studio: work arrives, triage decides what needs action, and agents take seats to work it.](https://raw.githubusercontent.com/ldbumble/taskuary/master/docs/hero.gif)
+
+Taskuary is early—currently **v0.3.2**—and moving fast. The funnel, review queue,
+agent sessions, and reports pipeline are in daily use; breaking changes are still possible
+before 1.0.
+
+## One timeline for incoming work
+
+Outlook, Gmail, Teams, Slack, Telegram, WhatsApp, GitHub, Jira, alerts, and reports all
+arrive on the same day-grouped rail. Each row says what it is and whether it needs you.
+Open one to see the full message, its attachments, why triage ruled that way, the drafted
+reply, and every available next step.
+
+![The Timeline with mail, chats, reports, active tasks, and an Assistant post on one rail.](https://raw.githubusercontent.com/ldbumble/taskuary/master/docs/screenshot-timeline-crop.png)
+
+Coding work can go straight to Claude Code, Codex, Gemini, Cursor, Copilot, or any CLI that
+accepts a prompt on stdin. You watch the live terminal, answer questions, review the diff,
+and approve what happens next. Research, marketing, and other general work belong in a
+conversational workspace built with assistant-ui and your existing Taskuary AI connections.
+Assistant and terminal are two views of the same session: model, history, queued instructions,
+image attachments, and the side-by-side browser stay put when you switch. The same workspace
+also appears on the Wall.
+
+## An assistant that notices what falls between tasks
+
+The Assistant periodically reads what the hub can see and posts only when it has something
+useful to say: a reply that went unanswered, a meeting that needs context, a task that went
+quiet, or a pattern across the week's work. Every suggestion includes its evidence and can
+be made into a task, dismissed, snoozed, or taught away with **Not this**.
+
+![An Assistant post showing two evidence-backed suggestions and what it reviewed.](https://raw.githubusercontent.com/ldbumble/taskuary/master/docs/screenshot-assistant.png)
+
+It watches the systems you run on, not only the hub. Point it at a Sage Intacct query, a
+database, a file, a REST or MCP tool, a cloud log group, or an agent skill—no saved report has
+to stand behind any of them—and it reads each one silently on every check. That step would
+otherwise ask you to know an object name and a list of field ids, so you can describe what it
+should keep an eye on instead and the AI writes the source cards: it may only choose systems you
+have actually connected, it reads the real schema before writing a query, and it asks rather
+than guessing a filter. The same help sits on every source card in the report builder.
+
+Its voice, schedule, model, and thresholds are yours to change. It leaves a note for its next
+check, does not repeat itself, and stays silent when there is nothing worth interrupting you
+for.
+
+## Install
+
+### Windows app
+
+Download the latest single-file
+[Taskuary.exe](https://github.com/ldbumble/taskuary/releases/latest/download/Taskuary.exe)
+and open it. No Python or installer is required.
+
+### Python
+
+Python 3.10 or newer works on Windows, macOS, and Linux:
+
+```bash
+pip install taskuary
+taskuary
+```
+
+Taskuary opens at [http://127.0.0.1:7787](http://127.0.0.1:7787). For a native desktop
+window instead, install `pip install "taskuary[desktop]"` and run `taskuary-desktop`.
+
+### Docker
+
+```bash
+git clone https://github.com/ldbumble/taskuary
+cd taskuary
+docker compose up
+```
+
+Then open [http://127.0.0.1:7787](http://127.0.0.1:7787). Docker runs the web app;
+coding CLIs and the optional WhatsApp bridge remain on the host.
+
+On first run, connect an AI provider or local Ollama model, add at least one inbound
+channel, then choose the coding CLI that should receive tasks. The setup wizards test each
+connection before it goes live.
+
+## Installs
+
+![Daily installs of taskuary from PyPI, mirror traffic excluded](https://raw.githubusercontent.com/ldbumble/taskuary/master/docs/downloads.svg)
+
+Redrawn every morning by [`downloads.yml`](.github/workflows/downloads.yml) from PyPI's own
+numbers, with mirror traffic excluded — a full PyPI mirror pulls every release, so counting it
+would let a handful of real users read as hundreds. What it does **not** claim is that CI
+installs have been removed: the field that would separate `pip install` in a build runner from
+one on somebody's laptop is in PyPI's BigQuery dataset, not in the public API. The daily series
+is [docs/downloads.csv](docs/downloads.csv).
+
+## Documentation
+
+- [Getting started](docs/getting-started.md)—installation, first-run setup, Docker, and data
+- [Product guide](docs/product-guide.md)—the workflow, learning loop, agents, and operator documents
+- [Integrations](docs/integrations.md)—channels, AI providers, work systems, and report sources
+- [Reports and the Assistant](docs/reports-and-assistant.md)—the report pipeline, letting the AI write the source cards, and what the Assistant watches
+- [Status and roadmap](docs/roadmap.md)—what works today and what is next
+- [Contributing](CONTRIBUTING.md)—development setup and contribution guide
+
+Taskuary is free and open source under the [MIT License](LICENSE). Issues and pull requests
+are welcome; security reports belong in [SECURITY.md](SECURITY.md).

{taskuary-0.3.1 → taskuary-0.3.2}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "taskuary"
-version = "0.3.1"
+version = "0.3.2"
 description = "Automate your job - the local-first operating system for your work: AI triage in, coding agents out."
 readme = "README.md"
 license = { text = "MIT" }
@@ -27,6 +27,7 @@ dependencies = [
     "pydantic>=2",
     "requests>=2.28",
     "loguru>=0.7",
+    "segno>=1.6",               # WhatsApp pairing QR drawn ON the card - pure Python, no Pillow
     "anthropic>=0.69",
     "tomli>=2; python_version<'3.11'",
     "websockets>=12",                            # uvicorn's ws transport - the terminal streams over it
@@ -38,6 +39,7 @@ dependencies = [
 mssql = ["pyodbc>=4"]
 db = ["sqlalchemy>=2"]      # 'any database' URLs; add the engine driver too (psycopg2-binary, pymysql, ...)
 aws = ["boto3>=1.28"]       # azure needs no extra: tokens ride plain requests
+voice = ["faster-whisper>=1.0"]   # Local Whisper: speech to text on this machine, no key, audio never leaves the box
 desktop = ["pywebview>=4"]
 build = ["pyinstaller>=6"]
 dev = ["pytest>=7", "httpx>=0.24", "openpyxl>=3"]   # openpyxl READS xlsx in tests; the writer is ours

{taskuary-0.3.1 → taskuary-0.3.2}/taskuary/__init__.py

@@ -1,4 +1,4 @@
-"""Taskuary - Automate your job: AI triage in, coding agents out, you in charge."""
+"""Taskuary - your work AI assistant: AI triage in, coding agents out, you in charge."""
 # ONE place holds the version and it is pyproject.toml, because that is the one the git tag has
 # to match (RELEASING.md). A second copy here said 0.2.0 through the whole of 0.2.1: the CLI
 # banner, the API and the header pill all reported it, and the header's own tooltip told the

{taskuary-0.3.1 → taskuary-0.3.2}/taskuary/agents.py

@@ -6,6 +6,7 @@ run so code changes are first-class, every run traced + audited.
 """
 import json, os, re, shutil, subprocess, threading, time
 from datetime import datetime
+from pathlib import Path
 from loguru import logger
 
 from .store import task_ref
@@ -75,26 +76,76 @@ def _shim_target(path: str) -> list:
     return []
 
 
+def _programs_copy(base: str) -> str:
+    """The ordinary per-user install of a CLI that is ALSO published as a Store app - codex ships
+    both. which() returns whichever comes first on PATH, and on some machines that is a stub this
+    account may not execute at all."""
+    root = os.path.join(os.environ.get('LOCALAPPDATA', ''), 'Programs')
+    want = base.lower()
+    for dirpath, dirs, files in os.walk(root):       # a missing root simply yields nothing
+        for f in files:
+            if f.lower() == want: return os.path.join(dirpath, f)
+        if dirpath.count(os.sep) - root.count(os.sep) >= 3: dirs.clear()   # vendor/app/bin is deep enough
+    return ''
+
+
 def _resolve_cmd(name: str) -> list:
     """Windows can't CreateProcess a bare 'claude': npm installs it as claude.cmd, which only
     PATH-resolves via which(). Reaching THROUGH the shim beats running it under cmd /c - see
     _shim_target for why that difference decides whether a prompt arrives whole."""
     path = shutil.which(name) or shutil.which(name, path=_fresh_path())
+    if not path and re.search(r'[\\/]', str(name)):
+        # A saved ABSOLUTE path that has moved. codex installs itself into
+        # ...\Codex\bin\<version hash>\codex.exe, so a profile pinned to one of those breaks on
+        # the next update and reads as "the CLI is gone". The NAME is the durable half: ask PATH
+        # again for it, which is what the owner would have done by hand.
+        base = re.split(r'[\\/]', str(name))[-1]
+        path = shutil.which(base) or shutil.which(base, path=_fresh_path())
+        if path: logger.info(f'{name} has moved; using {path} instead')
     if not path:
         raise FileNotFoundError(f"'{name}' not found on PATH - is the CLI installed?")
     if os.name == 'nt' and path.lower().endswith(('.cmd', '.bat')):
         return _shim_target(path) or ['cmd', '/c', path]
-    if os.name == 'nt' and '\\windowsapps\\' in path.lower() and '\\microsoft\\windowsapps\\' not in path.lower():
+    if os.name == 'nt' and '\\windowsapps\\' in path.lower():
         # which() walked into C:\Program Files\WindowsApps\<package>\...\codex.EXE - a Store package
         # folder, which CreateProcess is refused ([WinError 5] Access is denied). The runnable
         # thing is the execution ALIAS in the user's own WindowsApps folder; fall back to the
         # shell, which resolves aliases the way a typed command does.
         import ntpath   # a Windows path, split as one wherever this runs (CI is Linux and macOS)
-        alias = os.path.join(os.environ.get('LOCALAPPDATA', ''), 'Microsoft', 'WindowsApps', ntpath.basename(path))
+        base = ntpath.basename(path)
+        # An ordinary install beats either stub: the alias itself answers "Access is denied." when
+        # the package is not registered for this account, and cmd only forwards that refusal.
+        real = _programs_copy(base)
+        if real: return [real]
+        if '\\microsoft\\windowsapps\\' in path.lower(): return [path]     # the alias, and nothing better
+        alias = os.path.join(os.environ.get('LOCALAPPDATA', ''), 'Microsoft', 'WindowsApps', base)
         return [alias] if os.path.exists(alias) else ['cmd', '/c', name]
     return [path]
 
 
+def child_env() -> dict:
+    """The environment a CLI is entitled to expect.
+
+    codex refuses to start without one: `Error finding codex home: Could not find home
+    directory` (an owner's machine, 2026-08-31), and it is not a codex bug - a Taskuary
+    launched from a service, a scheduled task, or a shortcut with a scrubbed environment does
+    not always pass USERPROFILE down, and the Rust `dirs` crate has nothing else to go on.
+    Python can answer the question, so it answers it instead of letting the CLI guess: HOME
+    and USERPROFILE where they are missing, and CODEX_HOME - the variable codex checks FIRST,
+    before it ever asks the OS - pointed at the same place its own installer would use.
+    """
+    env = dict(os.environ)
+    try: home = str(Path.home())
+    except (RuntimeError, OSError): return env          # nothing better to say than nothing
+    env.setdefault('HOME', home)
+    if os.name == 'nt':
+        env.setdefault('USERPROFILE', home)
+        drive, tail = os.path.splitdrive(home)
+        if drive: env.setdefault('HOMEDRIVE', drive); env.setdefault('HOMEPATH', tail)
+    env.setdefault('CODEX_HOME', os.path.join(home, '.codex'))
+    return env
+
+
 def _fmt_input(inp) -> str:
     """The one field a human wants to see per tool call - command, path, pattern…"""
     if not isinstance(inp, dict): return str(inp)[:140]
@@ -146,16 +197,98 @@ def signed_out_msg(name: str, why: str) -> str:
     return f"{name} is signed out on this machine ({why.strip()[:160]}). Open a terminal, {how}, then come back here and try again."
 
 
-def run_cli(profile: dict, prompt: str, trace, resume: str = None):
+# Windows refuses to START some installs rather than failing inside them, and says only
+# "Access is denied." - which reads as an account or billing problem with the AI provider and is
+# nothing of the kind: the CLI never ran. Reported on another owner's machine (2026-08-31) as
+# `codex exit 1: Access is denied.` with no other output.
+_DENIED = re.compile(r'access is denied|winerror 5|permission denied|operation not permitted', re.I)
+_NO_HOME = re.compile(r'could not find home directory|finding codex home|HOME.{0,20}not set', re.I)
+
+
+def no_home_msg(name: str) -> str:
+    return (f'{name} could not find a home directory to keep its own settings and sign-in in. '
+            'Taskuary now hands every CLI a HOME, USERPROFILE and CODEX_HOME, so if this persists '
+            'the account running Taskuary has no profile directory at all - which happens when it '
+            'runs as a Windows service or a scheduled task under SYSTEM or a managed account. Run '
+            f'Taskuary as the same user who runs `{name}` in a terminal, or set CODEX_HOME '
+            'explicitly for that account, then sign in once with `codex login`.')
+
+
+def denied_msg(name: str, path: str, why: str) -> str:
+    where = f' ({path})' if path else ''
+    return (f'Windows would not start {name}{where}: "{str(why).strip()[:120]}". The CLI never ran, so '
+            f'this is not a sign-in or billing problem. Usual causes, in order: {name} came from the '
+            'Microsoft Store and its app-execution alias does not work for this account (install the '
+            'ordinary build instead, or reinstall it for this user); antivirus or an AppLocker policy is '
+            'blocking the executable; the folder the agent works in is not readable by this account. '
+            f'`where {name}` shows which copy is being found - running that exact path by hand '
+            'reproduces it in one line.')
+
+
+def _cli_name(cmd: str) -> str:
+    """Executable name for either a bare command or a Windows/POSIX path."""
+    return re.split(r'[\\/]', str(cmd or ''))[-1].lower().rsplit('.', 1)[0]
+
+
+def _codex_tool(item: dict):
+    """Turn a Codex JSONL item into the common visual tool name/input contract."""
+    typ = item.get('type')
+    if typ == 'command_execution': return 'shell', {'command': item.get('command') or ''}
+    if typ == 'file_change': return 'file change', {'changes': item.get('changes') or []}
+    if typ == 'mcp_tool_call':
+        return item.get('tool') or item.get('name') or 'MCP tool', item.get('arguments') or item.get('args') or {}
+    if typ == 'web_search': return 'web search', {'query': item.get('query') or ''}
+    return None
+
+
+def runs_here(profile: dict) -> bool:
+    """Does this profile's command resolve to something we can start?"""
+    try: return bool(_resolve_cmd((profile or {}).get('cmd') or 'claude'))
+    except (FileNotFoundError, OSError): return False
+
+
+def profiles(store) -> dict:
+    out = {}
+    for a in store.list_agents():
+        try: out[a['Name']] = json.loads(a.get('Config') or '{}')
+        except ValueError: out[a['Name']] = {}
+    return out
+
+
+def default_agent(store) -> str:
+    """Which agent a task goes to when nobody picked one.
+
+    The owner's choice wins - unless its CLI is not on this machine, in which case one that IS
+    beats a name that can only fail. Taskuary ships `coder` = claude, so on a machine with only
+    codex installed every dispatch died on a CLI nobody had, and the Board showed it as the
+    agent's failure (an owner's machine, 2026-08-31)."""
+    want = str(store.get_settings().get('default_agent') or 'coder').strip()
+    profs = profiles(store)
+    if want not in profs or runs_here(profs[want]): return want
+    return next((n for n, prof in profs.items() if runs_here(prof)), want)
+
+
+def run_cli(profile: dict, prompt: str, trace, resume: str = None, cancel=None):
     """One headless invocation of the configured CLI, output STREAMED line by line into
     the run trace so the Board shows the agent working live. claude's stream-json events
     render as readable tool/text lines; any other CLI's plain stdout streams as-is.
     Returns (result, session_id, diff)."""
     name = profile.get('cmd', 'claude')
-    cmd = _resolve_cmd(name) + list(profile.get('args') or preset_args(name) or ['-p'])
+    args = list(profile.get('args') or preset_args(name) or ['-p'])
+    # Codex's normal exec output is human prose with no boundary between commands, searches,
+    # edits and the final answer. JSONL is an exec-only presentation flag, so add it here (not
+    # to the saved profile, which is also used to open the interactive terminal TUI).
+    is_codex = _cli_name(name) == 'codex' and bool(args) and args[0] in ('exec', 'e')
+    if is_codex and '--json' not in args: args.append('--json')
+    cmd = _resolve_cmd(name) + args
     # which model works it: profile default, or a per-run override from the UI. The flag
     # name is configurable because every CLI spells it differently (claude/codex: --model).
-    if profile.get('model'): cmd += [profile.get('model_arg') or '--model', str(profile['model'])]
+    if profile.get('model'):
+        # 'gpt-5.4@high' spells a codex model and its reasoning level in one pick (climodels)
+        from .climodels import split_pick
+        m, eff = split_pick(profile['model'])
+        cmd += [profile.get('model_arg') or '--model', m]
+        if eff: cmd += ['-c', f'model_reasoning_effort={eff}']
     if resume and profile.get('resume_args'): cmd += list(profile['resume_args']) + [resume]
     cwd = profile.get('cwd')
     head0 = _git(cwd, 'rev-parse', 'HEAD')
@@ -163,22 +296,34 @@ def run_cli(profile: dict, prompt: str, trace, resume: str = None):
     trace('tool', 'cli', f'{name} cwd={cwd or os.getcwd()}' + (f' resume={resume}' if resume else ''))
     try:
         p = subprocess.Popen(cmd, stdin=subprocess.PIPE, stdout=subprocess.PIPE, stderr=subprocess.PIPE,
-                             text=True, encoding='utf-8', errors='replace', cwd=cwd, shell=False)
+                             text=True, encoding='utf-8', errors='replace', cwd=cwd, shell=False,
+                             env=child_env())
     except PermissionError as e:
-        # to the user this IS "not installed": whatever which() found, it cannot be run from here
-        raise FileNotFoundError(f"'{name}' is not installed or not on PATH - install it, then try again.") from e
+        # which() found something that cannot be executed from here. "Not installed" sent people
+        # off to reinstall a CLI that was already there; the reason is in denied_msg.
+        raise FileNotFoundError(denied_msg(name, cmd[0] if cmd else '', e)) from e
     timed = threading.Event()
     killer = threading.Timer(profile.get('timeout', 1200), lambda: (timed.set(), p.kill()))
     killer.start()
+    # A browser Cancel closes the streaming response. Kill the CLI too; otherwise the UI says
+    # stopped while an invisible agent keeps using tools in the background.
+    if cancel is not None:
+        def _cancel():
+            cancel.wait()
+            if cancel.is_set() and p.poll() is None:
+                try: p.kill()
+                except Exception: pass
+        threading.Thread(target=_cancel, daemon=True).start()
     err_buf = []
-    threading.Thread(target=lambda: err_buf.append(p.stderr.read()), daemon=True).start()
+    err_t = threading.Thread(target=lambda: err_buf.append(p.stderr.read()), daemon=True)
+    err_t.start()
     # stdin feed on its own thread: writing a big prompt while the child is already
     # emitting output can deadlock both pipes otherwise
     def _feed():
         try: p.stdin.write(prompt); p.stdin.close()
         except Exception: pass
     threading.Thread(target=_feed, daemon=True).start()
-    raw, final = [], None
+    raw, final, streamed_out, streamed_sid, open_tools = [], None, '', None, set()
     try:
         for line in p.stdout:
             line = line.rstrip('\n')
@@ -188,17 +333,57 @@ def run_cli(profile: dict, prompt: str, trace, resume: str = None):
             except ValueError: trace('live', name, line[:400]); continue
             if isinstance(j, dict) and (j.get('type') == 'result' or ('result' in j and 'type' not in j)):
                 final = j; continue
+            # Preserve the CLI's structured work for visual clients. The existing readable
+            # `live` line remains for Board traces and the terminal renderer.
+            if isinstance(j, dict) and j.get('type') == 'assistant':
+                for c in (j.get('message') or {}).get('content') or []:
+                    if c.get('type') == 'tool_use':
+                        trace('tool_call', c.get('name') or 'tool', {
+                            'tool_call_id': c.get('id') or f'tool-{len(raw)}', 'args': c.get('input') or {}})
+                    elif c.get('type') == 'text' and str(c.get('text') or '').strip():
+                        trace('progress', 'text', str(c['text']).strip())
+            elif isinstance(j, dict) and j.get('type') == 'user':
+                for c in (j.get('message') or {}).get('content') or []:
+                    if isinstance(c, dict) and c.get('type') == 'tool_result':
+                        trace('tool_result', c.get('tool_use_id') or 'tool', {
+                            'result': _result_text(c), 'is_error': bool(c.get('is_error'))})
+            # Codex `exec --json` speaks item lifecycle events instead of Claude content blocks.
+            # Normalize both into one stream so assistant-ui does not care which CLI is logged in.
+            if isinstance(j, dict) and j.get('type') == 'thread.started':
+                streamed_sid = j.get('thread_id') or streamed_sid
+            if isinstance(j, dict) and j.get('type') in ('item.started', 'item.updated', 'item.completed'):
+                item = j.get('item') or {}
+                iid = item.get('id') or f"item-{len(raw)}"
+                tool = _codex_tool(item)
+                if tool and iid not in open_tools:
+                    trace('tool_call', tool[0], {'tool_call_id': iid, 'args': tool[1]})
+                    open_tools.add(iid)
+                if tool and j.get('type') == 'item.completed':
+                    result = item.get('aggregated_output') or item.get('output') or item.get('status') or ''
+                    failed = item.get('status') == 'failed' or item.get('exit_code') not in (None, 0)
+                    trace('tool_result', iid, {'result': str(result), 'is_error': failed})
+                if item.get('type') in ('agent_message', 'reasoning') and str(item.get('text') or '').strip():
+                    text = str(item['text']).strip()
+                    trace('progress', item.get('type'), text)
+                    if item.get('type') == 'agent_message': streamed_out = text
             shown = _live_line(j) if isinstance(j, dict) else None
             if shown: trace('live', name, shown)
         p.wait()
     finally:
         killer.cancel()
+    err_t.join(5)      # the exit code can land before the stderr reader has appended - 'boom' read as 'no output' on a fast CI box
     if p.returncode != 0:
+        if cancel is not None and cancel.is_set(): raise RuntimeError('cancelled')
         why = f'timed out after {profile.get("timeout", 1200)}s' if timed.is_set() else \
             ((err_buf[0] if err_buf else '') or '\n'.join(raw[-5:]) or 'no output')[:500]
         if _SIGNED_OUT.search(why): raise RuntimeError(signed_out_msg(name, why))
+        # a refusal to START, not a failed run: the CLI produced no output of its own and the
+        # only thing on stderr is the refusal
+        if _DENIED.search(why) and not raw: raise RuntimeError(denied_msg(name, cmd[0] if cmd else '', why))
+        if _NO_HOME.search(why): raise RuntimeError(no_home_msg(_cli_name(name) or name))
         raise RuntimeError(f'{name} exit {p.returncode}: {why}')
     if final is not None: out, sid = str(final.get('result') or '').strip(), final.get('session_id')
+    elif streamed_out: out, sid = streamed_out, streamed_sid
     else: out, sid = parse_cli_json('\n'.join(raw))
     trace('output', name, out[-1000:])
     diff = ''
@@ -222,6 +407,9 @@ def task_context(store, task_id: int) -> str:
     lines += ['', 'Thread:'] + [f"- {c.get('Actor')}: {str(c.get('Body'))[:300]}" for c in d['comments']]
     mem = memory_block(store, d['messages'])
     if mem: lines += ['', mem]
+    from . import knowledge
+    kb = knowledge.block(store, ' '.join(f"{m.get('Subject') or ''} {m.get('BodyText') or ''}" for m in d['messages'])[:4000])
+    if kb: lines += [kb.strip()]
     return '\n'.join(lines)
 
 

{taskuary-0.3.1 → taskuary-0.3.2}/taskuary/aisetup.py

@@ -26,7 +26,7 @@ def live_for(store, cid: int):
     """The live setup session for this card, if one is open - the button reattaches instead of
     starting a second agent on the same form."""
     from . import terminal as term
-    for t in term.SESSIONS.values():
+    for t in list(term.SESSIONS.values()):
         if not (t.alive and t.task_id): continue
         tk = store.get_task(t.task_id) or {}
         if tk.get('Kind') == KIND and tag(cid) in str(tk.get('Tags') or ''): return {**t.info(), 'taskId': t.task_id}
@@ -85,7 +85,8 @@ def start(store, server: dict, cid: int, guide: list, fields: list = None, secre
     if not c: raise ValueError('connector not found')
     live = live_for(store, cid)
     if live: return {**live, 'existing': True}
-    agent = (agent or store.get_settings().get('default_agent') or 'coder').strip()
+    from . import agents as hub_agents
+    agent = (agent or hub_agents.default_agent(store)).strip()
     if not store.get_agent(agent): raise ValueError(f'no CLI agent named {agent!r} - add one under Connectors > AI CLI agents first')
     tid = store.create_task({'Title': f"Set up {c.get('Name') or c.get('Type')}", 'Kind': KIND, 'Status': 'in_progress', 'Tags': tag(cid),
                              'Summary': f"{agent} walks the owner through the {c.get('Type')} guide in a live session on the card and saves what they give it."}, actor)