ClintonEmok 4ade4450bf docs(skills): document programmatic-write scope cut in skills_guard module docstring ...

Enough1122's review on #92249 asked whether language write APIs
(Python open('w')/write_text/os.replace/shutil, Node fs.writeFileSync/
appendFile) are covered by the agent-config persistence tiers. They are
not: those tiers score shell redirection, sed -i, and imperative prose
only; language-API calls surface just the informational *_ref finding.

Static regexes cannot tie a dynamically-built path to the config-file
destination without executing the skill, so this is a documented scope
cut rather than missing coverage — runtime install gates remain the
backstop. Scoring behavior is unchanged, so SCANNER_VERSION stays at
skills-guard-v2 and cached verdicts remain valid.

Refs #92249

2026-08-28 03:24:43 -07:00

..

computer_use

fix(computer-use): accept current notarised CUA Driver

2026-08-27 20:21:34 +08:00

environments

refactor(terminal): honest schema, pager defaults in the env, unified notify arg (837 → 670 tok/call, −20%) (#95937)

2026-08-26 19:23:39 -07:00

neutts_samples

…

wakewords

feat(voice): bundle the trained "hey hermes" model as the out-of-the-box default

2026-07-28 07:58:16 -07:00

__init__.py

…

annotate_preview_tool.py

feat(desktop): durable element handles, and a delta instead of the whole page

2026-08-20 05:26:37 -05:00

ansi_strip.py

Port from block/goose#10746: strip invisible Unicode TAG chars from MCP content

2026-08-16 22:08:05 -07:00

apply_layout_tool.py

feat(desktop): agent-applied layout presets — apply_layout joins the desktop_ui toolset

2026-08-18 21:06:18 -05:00

approval.py

feat(code-execution): remote kernel host — session persistence for docker/ssh/modal backends (closes #96873) (#96991)

2026-08-28 01:39:33 -07:00

async_delegation.py

fix(delegation): expose state durability barriers

2026-08-27 13:48:51 -07:00

audio_container.py

refactor: extract shared audio container sniffer to tools/audio_container.py

2026-07-28 11:52:44 -07:00

binary_extensions.py

fix: cover remaining anydoc-extracted container formats

2026-08-15 02:51:59 +05:30

blueprints.py

fix(cron): surface initial scheduler registration failures

2026-08-07 17:45:06 +05:30

bot_failure_reasons.py

feat(bots): retry session policy — resume transient turns, compress-and-resume on context overflow (#93091 item 5)

2026-08-23 20:00:18 -07:00

bot_mode_dm.py

fix(bot-mode): keep delivery runner on host backend

2026-08-27 13:49:04 -07:00

bot_mode_probe.py

feat(bot-mode): bots on every Desktop connection can message each other

2026-08-23 02:16:11 -07:00

bot_relay.py

fix(bot-relay): add shutil.which step to CLI resolution and pin utf-8 decoding on delivery subprocess

2026-08-24 03:21:37 -07:00

browser_camofox_state.py

…

browser_camofox.py

feat(browser): make snapshot threshold configurable

2026-08-24 21:51:44 -07:00

browser_cdp_tool.py

feat(browser): add authenticated control broker

2026-08-21 22:33:45 +05:30

browser_dialog_tool.py

…

browser_extension_router.py

fix(browser): bind the extension lane at controller registration, not transport auth

2026-08-21 22:33:45 +05:30

browser_supervisor.py

perf(imports): lazy-load heavy SDKs off the cold-start waterfall

2026-07-29 10:54:04 -07:00

browser_tool.py

fix(browser): inline windows-footgun annotation for os.kill(pid, 0) (#85125 CI)

2026-08-27 16:11:16 +05:30

browser_use_cli.py

refactor(browser_exec): schema diet 803->663 tok/call, A/B-gated; eval harness runs on Windows + Nous auth (#96300)

2026-08-27 04:39:19 -07:00

budget_config.py

fix: read tool_budget config via load_config_readonly (config read guard)

2026-08-19 16:31:16 -07:00

checkpoint_manager.py

fix(checkpoints): display failed deletes to users and stabilize result keys

2026-08-26 18:02:17 +05:30

clarify_gateway.py

fix(gateway): cancel native clarify only on free prose

2026-08-14 21:24:36 -07:00

clarify_tool.py

refactor(clarify): schema diet + single questions[] interface (880 → 335 tok/call, −62%) (#95907)

2026-08-26 16:42:44 -07:00

close_preview_tool.py

feat(tools): close_preview so the agent can dismiss the pane it opened

2026-08-19 14:59:51 -05:00

close_terminal_tool.py

fix(agent): the desktop's tools reach it on remote and cloud backends too

2026-08-06 19:35:47 -06:00

code_execution_tool.py

fix(execute_code): limits line teaches spillover instead of a bare 50KB cap (#97048)

2026-08-28 03:17:05 -07:00

code_kernel_remote.py

feat(code-execution): remote kernel host — session persistence for docker/ssh/modal backends (closes #96873) (#96991)

2026-08-28 01:39:33 -07:00

code_kernel.py

feat(execute_code): stdout spillover — truncated output's full text saved to cache/exec (host) or kernel tmpdir (cells), path + read_file recipe in the result (#97043)

2026-08-28 03:05:03 -07:00

computer_use_tool.py

feat(computer_use): align cua-driver 0.10 permission modes

2026-07-29 12:19:37 -07:00

credential_files.py

feat(terminal): pluggable terminal environment backends via plugin registry

2026-08-24 20:10:44 -07:00

cronjob_tools.py

fix(cron): transient run prompt survives the relay-fronted gateway forward

2026-08-27 20:53:02 -07:00

daemon_pool.py

fix(cli): reliable interrupts, bounded exit, and exit feedback (#57000)

2026-07-02 04:20:43 -07:00

debug_helpers.py

…

delegate_tool.py

refactor(delegate_task): tasks-only interface + depth-derived delegation (1,201 → 773 tok/call, −36%) (#96424)

2026-08-27 07:38:53 -07:00

delegation_live_log.py

feat(delegation): record model/provider in live-transcript manifest (#telemetry)

2026-08-16 20:14:51 -07:00

delegation_output_schema.py

feat(delegation): optional structured-output schema on delegate_task

2026-08-07 09:07:42 -07:00

desktop_ui.py

feat(desktop): agent can focus panes + shared desktop-UI event bridge

2026-07-22 12:13:01 -05:00

discord_tool.py

fix(tools): isolate model tools by multiplex profile

2026-08-02 00:11:50 -07:00

drive_preview_tool.py

feat(desktop): durable element handles, and a delta instead of the whole page

2026-08-20 05:26:37 -05:00

env_passthrough.py

fix(security): scope passthrough env to routed profile

2026-08-02 00:36:03 -07:00

env_probe.py

feat(terminal): pluggable terminal environment backends via plugin registry

2026-08-24 20:10:44 -07:00

fal_common.py

…

feishu_doc_tool.py

…

feishu_drive_tool.py

…

file_operations.py

fix(search): path-scoped grep pruning + execution-backend gating for macOS TCC exclusions

2026-08-26 06:26:02 -07:00

file_state.py

…

file_tools.py

fix: avoid macOS privacy prompts during broad searches

2026-08-26 06:26:02 -07:00

focus_pane_tool.py

feat(tools): close_preview so the agent can dismiss the pane it opened

2026-08-19 14:59:51 -05:00

fuzzy_match.py

refactor(tools): extract IDENTICAL_STRINGS_ERROR constant

2026-08-12 15:21:47 +05:30

homeassistant_tool.py

fix(tools): isolate model tools by multiplex profile

2026-08-02 00:11:50 -07:00

hook_output_spill.py

fix(tools): symlink-safe exclusive creation for all spill/cache writers

2026-08-13 11:09:51 -07:00

image_generation_tool.py

fix(tools): dispatch image/video FAL strictly on the stored hermes tools selection

2026-08-19 16:10:01 -07:00

image_source.py

fix(image_gen): confine generation source images to the terminal backend

2026-08-08 04:19:38 -07:00

interpreter_shutdown.py

fix: quitting the CLI no longer spams shutdown-race API errors onto the shell

2026-08-23 16:04:41 -07:00

interrupt.py

fix(code-exec): preserve interrupt cancellation source

2026-08-23 18:25:19 -07:00

kanban_tools.py

feat(kanban): explicit notify/wake delivery modes with faithful wake session routing

2026-08-13 10:47:40 -07:00

lazy_deps.py

fix(teams): do not call App() when the SDK was never bound

2026-08-25 12:07:33 +05:30

managed_tool_gateway.py

fix(gateway): read auth.json as UTF-8 in _read_nous_provider_state

2026-08-08 12:32:23 -07:00

mcp_dashboard_oauth.py

fix(mcp): preserve live OAuth state during reauth

2026-07-17 04:50:47 -07:00

mcp_oauth_manager.py

feat(mcp): per-server oauth.user_agent for token-endpoint requests (#75576)

2026-08-18 21:57:53 -07:00

mcp_oauth.py

docs: update secure_parent_dir docstring and caller comments for the install-tree exclusion

2026-08-25 10:55:53 +10:00

mcp_schema_cache.py

feat(mcp): speak the 2026-07-28 stateless protocol

2026-08-17 03:03:35 -07:00

mcp_stdio_watchdog.py

fix(mcp): use direct parent identity in stdio watchdog

2026-07-18 04:15:13 -07:00

mcp_tool.py

review: tighten pre-call gate comment; drop redundant _ReadyAdapter test stub

2026-08-27 21:36:35 +05:30

memory_tool.py

fix(memory): bound invalid-target error and restore recovery hint

2026-08-20 20:20:23 -07:00

microsoft_graph_auth.py

…

microsoft_graph_client.py

fix(teams): request supported transcript content format

2026-08-26 02:54:35 +05:30

neutts_synth.py

fix(voice): reconcile NeuTTS backbone/codec GPU device strings

2026-07-28 14:07:21 -07:00

open_preview_tool.py

feat(tools): close_preview so the agent can dismiss the pane it opened

2026-08-19 14:59:51 -05:00

openrouter_client.py

fix(secrets): scope-aware credential reads in core tool/gateway/web-server paths

2026-08-02 10:02:33 -07:00

osv_check.py

fix(security): cache OSV malware preflight verdicts and stop double component discovery (#75485)

2026-08-01 10:47:20 -07:00

patch_parser.py

fix(tools): skip degenerate identical hunks in V4A validation

2026-08-12 15:21:47 +05:30

path_security.py

refactor: migrate hand-rolled error envelopes to shared tool_error()

2026-07-29 10:14:00 -07:00

plugin_guard.py

Inspired by Claude Cowork: security scanning for plugin install/update

2026-08-16 22:08:37 -07:00

process_registry.py

refactor(terminal): honest schema, pager defaults in the env, unified notify arg (837 → 670 tok/call, −20%) (#95937)

2026-08-26 19:23:39 -07:00

project_tools.py

fix(projects): dedup project_create by primary_path (#75820)

2026-08-15 00:33:11 -07:00

react_to_message_tool.py

fix(state): close leaked SessionDB connections on exception paths (#83226)

2026-08-14 21:41:26 -07:00

read_extract.py

feat(read): jq retrieval hint in notebook output truncation marker

2026-08-10 01:28:57 -07:00

read_preview_tool.py

feat(tools): close_preview so the agent can dismiss the pane it opened

2026-08-19 14:59:51 -05:00

read_terminal_tool.py

fix(agent): the desktop's tools reach it on remote and cloud backends too

2026-08-06 19:35:47 -06:00

read_window_tool.py

fix(desktop): say why read_window_below cannot see the windows

2026-08-08 22:17:38 -05:00

registry.py

fix(browser): harden extension controller routing

2026-08-21 22:33:45 +05:30

schema_sanitizer.py

feat(mcp): collapse const-only anyOf/oneOf unions to property enums

2026-08-07 08:58:25 -07:00

self_repo_guard.py

fix: make the self-repo git guard Windows-only

2026-08-17 10:03:36 -07:00

send_message_tool.py

fix(send_message): cross-loop dispatch to live WeCom adapter

2026-08-27 07:33:36 -07:00

session_search_tool.py

refactor(session_search): halve the schema (1570->695 tok/call); teachings move into response hints

2026-08-26 07:26:38 -07:00

setup_mcp_tool.py

feat(desktop): setup_mcp tool — inline MCP consent card over the clarify-style blocking bridge

2026-08-13 01:06:51 -05:00

shell_heredoc.py

perf(tools): linear-time masking rebuild + last-opener early exit

2026-08-12 13:57:59 +05:30

skill_ledger.py

feat(curator): per-mutation audit ledger + single-edit rollback

2026-08-16 22:06:41 -07:00

skill_linter.py

fix: suppress windows-footgun false positives in linter pattern list

2026-08-08 11:12:27 -07:00

skill_manager_tool.py

refactor(skills): skill_manage 924 → 518 tok/call — dedup diet, retire 'edit', unadvertise curator-only absorbed_into (#95697)

2026-08-26 15:13:30 -07:00

skill_provenance.py

…

skill_usage.py

fix(curator): check unpin result, guard status ghost rows, tighten test

2026-08-23 21:12:20 -07:00

skillevaluator_scan.py

fix: address second-round SkillEvaluator review feedback

2026-08-17 17:04:40 -07:00

skills_ast_audit.py

…

skills_guard.py

docs(skills): document programmatic-write scope cut in skills_guard module docstring

2026-08-28 03:24:43 -07:00

skills_hub.py

refactor: consolidate owner extraction onto _owner_from_payload

2026-08-19 01:23:17 +05:30

skills_sync_client.py

fix(sync): read org state from the org endpoints, not the personal ones (#75237)

2026-07-30 22:31:42 -07:00

skills_sync.py

fix: system prompt no longer references tools/skills the session can't use; hermes-agent skill is always kept

2026-08-24 20:25:10 -07:00

skills_tool.py

feat(terminal): pluggable terminal environment backends via plugin registry

2026-08-24 20:10:44 -07:00

slash_confirm.py

…

spill_safety.py

fix(tools): symlink-safe exclusive creation for all spill/cache writers

2026-08-13 11:09:51 -07:00

subagent_worktree.py

fix(delegate): disclaim only the fields a failed probe actually left unmeasured

2026-08-17 19:41:32 +05:30

terminal_hints.py

fix(terminal): warn when exit_code 0 masks a piped build/test failure

2026-08-15 23:48:15 -07:00

terminal_tool.py

fix(bot-mode): keep delivery runner on host backend

2026-08-27 13:49:04 -07:00

thread_context.py

…

threat_patterns.py

…

tip_tool.py

feat(desktop): make the idle tip rotation opt-in, ungate the tool

2026-08-27 21:50:18 -05:00

tirith_security.py

fix(secrets): scope tier-3 credential reads (teams_pipeline, deepinfra models, FAL/XAI/VERCEL/DAYTONA/GITHUB presence, HERMES_API_KEY display)

2026-08-02 10:04:48 -07:00

todo_tool.py

feat: execution-discipline guidance now reaches all tool-capable models (config model.execution_guidance)

2026-08-19 16:16:37 -07:00

tool_backend_helpers.py

fix(tools): honor raw stt.provider: local; finish _reconfigure_provider provider-string migration

2026-08-19 16:10:01 -07:00

tool_output_limits.py

…

tool_result_storage.py

feat: identical re-calls enter context as reference stubs, not duplicate payloads

2026-08-20 00:16:22 -07:00

tool_search.py

refactor(tool-search): keep batch caps internal

2026-08-25 16:39:12 -07:00

tour_tool.py

feat(tools): tour — let the agent walk a user through the UI

2026-08-19 00:52:54 -05:00

transcription_tools.py

fix(stt): surface the selection-specific error for explicit openai STT

2026-08-23 18:25:35 -07:00

tts_streaming.py

fix(tts): route streaming-provider secrets through resolve_provider_secret; bound per-sentence stream bodies at 16 MiB

2026-07-28 22:31:40 -07:00

tts_text_normalize.py

fix(tts): unify TTS text preprocessing behind one shared cleaner

2026-07-28 11:55:01 -07:00

tts_tool.py

fix(voice): route TTS/STT OpenAI audio on the stored selection, not credentials

2026-08-19 16:10:01 -07:00

url_safety.py

fix: scope private URL policy per profile

2026-07-28 14:17:45 -07:00

video_generation_tool.py

Add more FAL models to nous portal (#82019)

2026-08-08 19:59:12 -04:00

vision_tools.py

fix(vision): review follow-ups — LA/PA JPEG guard, third embed site

2026-08-23 15:06:03 +05:30

voice_client_config.py

feat(desktop): client-direct voice — use the active profile's STT/TTS keys from the desktop, no audio relay

2026-08-23 03:54:52 -07:00

voice_mode.py

feat(plugins): add pre_transcription hook and STT prompt threading

2026-08-12 19:01:30 -07:00

wake_word.py

fix(wake-word): capture at native input rate

2026-08-08 13:49:24 +05:30

web_result_cache.py

feat(web): cache_exempt_hosts — always-live fetches for staging/tunnel sites

2026-08-25 04:21:45 -07:00

web_tools.py

fix(web): extract cache serves only after policy + provider gates; rescue and format/provider isolation

2026-08-25 04:21:45 -07:00

website_policy.py

fix(website-policy): key blocklist cache on the real default config path

2026-07-04 15:08:49 -07:00

working_diff.py

fix(tools): decode git output as UTF-8 in working_diff on Windows

2026-08-08 12:34:46 -07:00

write_approval.py

…

x_search_tool.py

refactor(xai): lift API-key precedence into resolve_xai_http_credentials behind prefer_api_key

2026-08-16 21:20:29 -07:00

xai_http.py

refactor(xai): lift API-key precedence into resolve_xai_http_credentials behind prefer_api_key

2026-08-16 21:20:29 -07:00

xai_video_tools.py

…

yuanbao_tools.py

…