Skip to content

fix(code): resume hints echo the launched command name - #5119

Merged
Mason Daugherty (mdrxy) merged 6 commits into
mainfrom
mdrxy/code/invoked-binary-name
Jul 29, 2026
Merged

fix(code): resume hints echo the launched command name#5119
Mason Daugherty (mdrxy) merged 6 commits into
mainfrom
mdrxy/code/invoked-binary-name

Conversation

@mdrxy

@mdrxy Mason Daugherty (mdrxy) commented Jul 28, 2026 •
edited
Loading

Copy link
Copy Markdown
Member

Resume hints now name the command you actually launched — deepagents-code, or a renamed shim such as abc — instead of always saying dcode.

The package ships two console scripts (dcode and deepagents-code), and a common way to run several checkouts side by side is a renamed symlink in ~/.local/bin pointing at a worktree's dcode script. Both resume hints (the teardown "Resume this thread with:" line and the relaunch hint after an agent switch) hardcoded dcode, so those users were told to run a command that may not exist on their PATH.

The launch name is recoverable: for a shebang console script the kernel hands the interpreter the pathname passed to execve rather than the symlink target, so sys.argv[0] keeps the shim name. invoked_name resolves it and falls back to dcode when the value cannot be a command the user typed — python -m deepagents_code reports __main__.py, an embedded interpreter may leave sys.argv empty, and the value is rendered into a copy-pasteable command, so the shape is allowlisted rather than escaped. The startup auto-update re-execs as python -m deepagents_code, which discards argv[0], so the resolved name is handed to the next generation through an internal env sentinel (the same pattern as the existing restart loop-guard sentinel).

Deliberately out of scope: the hand-maintained --help usage lines still hardcode dcode. That is a mechanical swap of roughly a hundred literals guarded by the help-screen drift test, and is better reviewed on its own.

Made by Open SWE

@mdrxy @open-swe
feat(code): resume hints echo the launched command name
675b258 
Resume hints hardcoded `dcode`, so users who launch through the
`deepagents-code` alias or a renamed per-checkout shim were told to run a
command they may not have. Resolve the launch name from `sys.argv[0]`,
carrying it across the auto-update re-exec (which drops argv[0]) in an
internal env sentinel, and fall back to `dcode` when the name is not a
plausible command.

Co-authored-by: open-swe[bot] <open-swe@users.noreply.github.com>
@github-actions github-actions Bot added dcode Related to `deepagents-code` feature New feature/enhancement or request for one internal User is a member of the `langchain-ai` GitHub organization size: M 200-499 LOC labels Jul 28, 2026
@mdrxy Mason Daugherty (mdrxy) mentioned this pull request Jul 28, 2026
Merged
Mason Daugherty (mdrxy) added a commit that referenced this pull request Jul 28, 2026
@mdrxy
docs(repo): clarify PR body is release note without heading (#5121)
0fd459c 
PR descriptions that mention `release-note-ready` text still led agents
to append a separate `## Release Note` section that duplicated the
frontmatter summary. Clarifies that the plain paragraph above `---` is
the release note, bans both heading casings, and shows the anti-pattern.

---

The release-note content already belongs in the unlabeled opening
summary. Agents were treating "release-note-ready" as a cue to add a
second section. Tightens the wording in contributor agent guidance and
the GitHub PR template so the rule is positive ("that paragraph is the
release note") and includes a concrete bad example.

Related #5119

---------

Signed-off-by: Mason Daugherty <mason@langchain.dev>
@mdrxy
Mason Daugherty (mdrxy) marked this pull request as ready for review July 29, 2026 19:11
Mason Daugherty (mdrxy) and others added 4 commits July 29, 2026 15:11
@mdrxy
Merge branch 'main' into mdrxy/code/invoked-binary-name
a427711
@mdrxy
Merge branch 'main' into mdrxy/code/invoked-binary-name
ef7e744
@mdrxy
fix(code): exclude DEEPAGENTS_CODE_INVOKED_AS from config manifest co…
7151e93 
…verage

The env-var drift test flags DEEPAGENTS_CODE_INVOKED_AS as lacking a manifest entry. It is an internal sentinel set by the self-update restart handshake to carry the launched command name into the re-exec'd process — never user-configured — so it belongs in NON_OPTION_ENV_VARS alongside the other internal/transient signaling flags.
@mdrxy
feat(code): note non-standard invoked binary name in Debug Console
56a1ed3 
When dcode is launched through a renamed shim or alias, resume hints echo
that name, and a wrong hint was previously impossible to trace back to how
the launch name was resolved. cli_main now logs a once-per-process note
naming the resolved command when it is not one of the shipped console
scripts (dcode, deepagents-code).

The note is never user-facing: it logs at INFO when debug mode is off so
it passes the package logger's buffer floor and lands only in the in-app
Debug Console (the buffer is the sole handler, so nothing prints), and at
DEBUG when DEEPAGENTS_CODE_DEBUG is on so it also joins the debug log
file.
@github-actions github-actions Bot added size: L 500-999 LOC and removed size: M 200-499 LOC labels Jul 29, 2026
@mdrxy Mason Daugherty (mdrxy) changed the title feat(code): resume hints echo the launched command name fix(code): resume hints echo the launched command name Jul 29, 2026
@github-actions github-actions Bot added fix A bug fix (PATCH) and removed feature New feature/enhancement or request for one labels Jul 29, 2026
@mdrxy
Mason Daugherty (mdrxy) merged commit 991b7e7 into main Jul 29, 2026
69 checks passed
@mdrxy
Mason Daugherty (mdrxy) deleted the mdrxy/code/invoked-binary-name branch July 29, 2026 21:41
@github-actions github-actions Bot mentioned this pull request Jul 29, 2026
Merged
Marcelo5444 pushed a commit to Marcelo5444/deepagents that referenced this pull request Jul 30, 2026
@mdrxy
docs(repo): clarify PR body is release note without heading (langchai…
b4506e0 
…n-ai#5121)

PR descriptions that mention `release-note-ready` text still led agents
to append a separate `## Release Note` section that duplicated the
frontmatter summary. Clarifies that the plain paragraph above `---` is
the release note, bans both heading casings, and shows the anti-pattern.

---

The release-note content already belongs in the unlabeled opening
summary. Agents were treating "release-note-ready" as a cue to add a
second section. Tightens the wording in contributor agent guidance and
the GitHub PR template so the rule is positive ("that paragraph is the
release note") and includes a concrete bad example.

Related langchain-ai#5119

---------

Signed-off-by: Mason Daugherty <mason@langchain.dev>
Marcelo5444 pushed a commit to Marcelo5444/deepagents that referenced this pull request Jul 30, 2026
@mdrxy @open-swe
fix(code): resume hints echo the launched command name (langchain-ai#…
6cd6d22 
…5119)

Resume hints now name the command you actually launched —
`deepagents-code`, or a renamed shim such as `abc` — instead of always
saying `dcode`.

---

The package ships two console scripts (`dcode` and `deepagents-code`),
and a common way to run several checkouts side by side is a renamed
symlink in `~/.local/bin` pointing at a worktree's `dcode` script. Both
resume hints (the teardown "Resume this thread with:" line and the
relaunch hint after an agent switch) hardcoded `dcode`, so those users
were told to run a command that may not exist on their `PATH`.

The launch name is recoverable: for a shebang console script the kernel
hands the interpreter the pathname passed to `execve` rather than the
symlink target, so `sys.argv[0]` keeps the shim name. `invoked_name`
resolves it and falls back to `dcode` when the value cannot be a command
the user typed — `python -m deepagents_code` reports `__main__.py`, an
embedded interpreter may leave `sys.argv` empty, and the value is
rendered into a copy-pasteable command, so the shape is allowlisted
rather than escaped. The startup auto-update re-execs as `python -m
deepagents_code`, which discards `argv[0]`, so the resolved name is
handed to the next generation through an internal env sentinel (the same
pattern as the existing restart loop-guard sentinel).

Deliberately out of scope: the hand-maintained `--help` usage lines
still hardcode `dcode`. That is a mechanical swap of roughly a hundred
literals guarded by the help-screen drift test, and is better reviewed
on its own.

Made by [Open
SWE](https://openswe.vercel.app/agents/42e64bd7-ceac-c324-9036-69205c1754bc)

---------

Co-authored-by: open-swe[bot] <open-swe@users.noreply.github.com>
Mason Daugherty (mdrxy) pushed a commit that referenced this pull request Jul 30, 2026
@github-actions @langchain-oss-automated-triage @johannes117
release(deepagents-code): 0.1.50 (#5102)
63adb96 
> [!CAUTION]
> Merging this PR will automatically publish to **PyPI** and create a
**GitHub release**.

For the full release process, see
[`.github/RELEASING.md`](https://github.com/langchain-ai/deepagents/blob/main/.github/RELEASING.md).

---

_Release notes preview: keep this section in sync with the package
`CHANGELOG.md`. Publish reads the merged CHANGELOG via `release.yml`,
not this PR description — keep them aligned anyway so the PR stays an
accurate historical record for reviewers and anyone returning later._

---


##
[0.1.50](deepagents-code==0.1.49...deepagents-code==0.1.50)
(2026-07-30)

### Highlights

- Added project hooks workspace trust and expanded Hooks v2 support with
client and server lifecycle events plus runtime feedback
([#5105](#5105),
[#5104](#5104),
[#4997](#4997),
[#5045](#5045)).
- Added an option to mute the “YOLO is active” toast
([#5103](#5103)).
- Made the splash screen `thread` ID clickable to copy it
([#5173](#5173)).
- Show `ask_user` answers directly on the answered tool row
([#5100](#5100)).
- Show a toast when submitting an empty required `ask_user` answer
([#5095](#5095)).
- Added thread message counts to the Debug Console
([#5117](#5117)).

### Fixes and improvements

- Gated Hooks v2 behind `DEEPAGENTS_CODE_EXPERIMENTAL` and improved hook
resume stability across identity and Command tool results
([#5146](#5146),
[#5176](#5176)).
- Kept server hook state out of task results
([#5164](#5164)).
- Stopped duplicate Auto transcript events during interrupt replay
([#5157](#5157)).
- Kept `/update` and `/install --package` prompts responsive
([#5127](#5127)).
- Refreshed the `/threads` cache after each turn
([#5174](#5174)).
- Anchored toasts above the chat input and added a toast when media is
dropped into a free-text question
([#5101](#5101),
[#5099](#5099)).
- Improved thread status message styling and links
([#5118](#5118)).
- Made resume hints echo the launched command name
([#5119](#5119)).
- Scoped selection copy to the clicked screen
([#5140](#5140)).
- Ignored mouse hits on detached widgets
([#5114](#5114)).

_End release notes preview._

---

> [!NOTE]
> A **New Contributors** section is appended to the GitHub release notes
automatically at publish time (see [Release
Pipeline](https://github.com/langchain-ai/deepagents/blob/main/.github/RELEASING.md#release-pipeline),
step 2).

---------

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: langchain-oss-automated-triage[bot] <248757908+langchain-oss-automated-triage[bot]@users.noreply.github.com>
Co-authored-by: Johannes du Plessis <johannes@langchain.dev>
Mason Daugherty (mdrxy) added a commit that referenced this pull request Jul 30, 2026
@mdrxy @open-swe
fix(code): resume hints echo the launched command name (#5119)
a3e9efc 
Resume hints now name the command you actually launched —
`deepagents-code`, or a renamed shim such as `abc` — instead of always
saying `dcode`.

---

The package ships two console scripts (`dcode` and `deepagents-code`),
and a common way to run several checkouts side by side is a renamed
symlink in `~/.local/bin` pointing at a worktree's `dcode` script. Both
resume hints (the teardown "Resume this thread with:" line and the
relaunch hint after an agent switch) hardcoded `dcode`, so those users
were told to run a command that may not exist on their `PATH`.

The launch name is recoverable: for a shebang console script the kernel
hands the interpreter the pathname passed to `execve` rather than the
symlink target, so `sys.argv[0]` keeps the shim name. `invoked_name`
resolves it and falls back to `dcode` when the value cannot be a command
the user typed — `python -m deepagents_code` reports `__main__.py`, an
embedded interpreter may leave `sys.argv` empty, and the value is
rendered into a copy-pasteable command, so the shape is allowlisted
rather than escaped. The startup auto-update re-execs as `python -m
deepagents_code`, which discards `argv[0]`, so the resolved name is
handed to the next generation through an internal env sentinel (the same
pattern as the existing restart loop-guard sentinel).

Deliberately out of scope: the hand-maintained `--help` usage lines
still hardcode `dcode`. That is a mechanical swap of roughly a hundred
literals guarded by the help-screen drift test, and is better reviewed
on its own.

Made by [Open
SWE](https://openswe.vercel.app/agents/42e64bd7-ceac-c324-9036-69205c1754bc)

---------

Co-authored-by: open-swe[bot] <open-swe@users.noreply.github.com>
Mason Daugherty (mdrxy) pushed a commit that referenced this pull request Jul 30, 2026
@github-actions @langchain-oss-automated-triage
@johannes117 @mdrxy
release(deepagents-code): 0.1.50 (#5102)
b1abf4b 
> [!CAUTION]
> Merging this PR will automatically publish to **PyPI** and create a
**GitHub release**.

For the full release process, see
[`.github/RELEASING.md`](https://github.com/langchain-ai/deepagents/blob/main/.github/RELEASING.md).

---

_Release notes preview: keep this section in sync with the package
`CHANGELOG.md`. Publish reads the merged CHANGELOG via `release.yml`,
not this PR description — keep them aligned anyway so the PR stays an
accurate historical record for reviewers and anyone returning later._

---


##
[0.1.50](deepagents-code==0.1.49...deepagents-code==0.1.50)
(2026-07-30)

### Highlights

- Added project hooks workspace trust and expanded Hooks v2 support with
client and server lifecycle events plus runtime feedback
([#5105](#5105),
[#5104](#5104),
[#4997](#4997),
[#5045](#5045)).
- Added an option to mute the “YOLO is active” toast
([#5103](#5103)).
- Made the splash screen `thread` ID clickable to copy it
([#5173](#5173)).
- Show `ask_user` answers directly on the answered tool row
([#5100](#5100)).
- Show a toast when submitting an empty required `ask_user` answer
([#5095](#5095)).
- Added thread message counts to the Debug Console
([#5117](#5117)).

### Fixes and improvements

- Gated Hooks v2 behind `DEEPAGENTS_CODE_EXPERIMENTAL` and improved hook
resume stability across identity and Command tool results
([#5146](#5146),
[#5176](#5176)).
- Kept server hook state out of task results
([#5164](#5164)).
- Stopped duplicate Auto transcript events during interrupt replay
([#5157](#5157)).
- Kept `/update` and `/install --package` prompts responsive
([#5127](#5127)).
- Refreshed the `/threads` cache after each turn
([#5174](#5174)).
- Anchored toasts above the chat input and added a toast when media is
dropped into a free-text question
([#5101](#5101),
[#5099](#5099)).
- Improved thread status message styling and links
([#5118](#5118)).
- Made resume hints echo the launched command name
([#5119](#5119)).
- Scoped selection copy to the clicked screen
([#5140](#5140)).
- Ignored mouse hits on detached widgets
([#5114](#5114)).

_End release notes preview._

---

> [!NOTE]
> A **New Contributors** section is appended to the GitHub release notes
automatically at publish time (see [Release
Pipeline](https://github.com/langchain-ai/deepagents/blob/main/.github/RELEASING.md#release-pipeline),
step 2).

---------

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: langchain-oss-automated-triage[bot] <248757908+langchain-oss-automated-triage[bot]@users.noreply.github.com>
Co-authored-by: Johannes du Plessis <johannes@langchain.dev>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

No reviews

Assignees

No one assigned

Labels

dcode Related to `deepagents-code` fix A bug fix (PATCH) internal User is a member of the `langchain-ai` GitHub organization size: L 500-999 LOC

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

1 participant

@mdrxy