Commit Graph

11 Commits

Author SHA1 Message Date
sukh 883581cda6 fix(deepagents): handle Windows absolute paths in tsdown external filter (#489)
## Fix: `ERR_MODULE_NOT_FOUND` on Windows when building `deepagents`

### Problem

Building `libs/deepagents` on Windows produces a `dist/index.js` that
imports
local modules with `.ts` extensions instead of bundling them:

```js
import { createDeepAgent } from "./agent.ts";
import { ConfigurationError } from "./errors.ts";
```

This causes an immediate crash at runtime for any consumer of the
library:

```
Error [ERR_MODULE_NOT_FOUND]: Cannot find module
  'C:\...\deepagentsjs\libs\deepagents\dist\agent.ts'
  imported from C:\...\deepagentsjs\libs\deepagents\dist\index.js
  ```

  **Root Cause**
The `external` filter in `libs/deepagents/tsdown.config.ts:` used a regex intended to match
only npm package names (which don't start with `.` or `/`):

```js
const external = [/^[^./]/];
```
On Unix absolute paths start with `/` so the regex correctly excludes them. On Windows absolute paths start with a drive letter (e.g. C:\...), which also doesn't start with `.` or `/` - so rolldown matches them as external, excludes them from the bundle, and leaves raw `.ts` references in the output.

**Fix**
Replace the regex with a function that explicitly excludes Windows-style
absolute paths:
```js
const external = (id: string) =>
!id.startsWith(".") && !id.startsWith("/") &&
!/^[A-Za-z]:[\\/]/.test(id);
```

After this change `pnpm -w run build` in `libs/deepagents` produces a fully
bundled `[dist/index.js]` with no `.ts` imports and examples run correctly on Windows.

Notes

- `deps.neverBundle` (the tsdown-recommended replacement for `[external]` is not yet functional in tsdown 0.21.7 / rolldown 1.0.0-rc.12 and causes a build error. This fix is the correct workaround until that API stabilises.

---------

Co-authored-by: Hunter Lovell <hunter@hntrl.io>
2026-04-27 13:57:05 -07:00
github-actions[bot] 02c1c7fa38 chore: version packages (#433)
* chore: version packages

* cr

---------

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Hunter Lovell <hunter@hntrl.io>
2026-04-07 08:48:53 -07:00
dependabot[bot] 67d7423c82 build(deps-dev): bump typescript from 5.9.3 to 6.0.2 (#409)
Bumps [typescript](https://github.com/microsoft/TypeScript) from 5.9.3 to 6.0.2.
- [Release notes](https://github.com/microsoft/TypeScript/releases)
- [Commits](https://github.com/microsoft/TypeScript/compare/v5.9.3...v6.0.2)

---
updated-dependencies:
- dependency-name: typescript
  dependency-version: 6.0.2
  dependency-type: direct:development
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-04-01 21:29:10 -07:00
Hunter Lovell ca5cc0acfb chore: merge alpha into main (#404)
* Revert "revert: "feat(deepagents): support multimodal files for backends (#298)" (#352)" (#353)

This reverts commit 03ea1c9729.

* revert: "revert: "feat(sdk): add async subagent middleware for remote LangGraph servers  (#323)" (#351)" (#354)

* Revert "revert: "feat(sdk): add async subagent middleware for remote LangGraph servers  (#323)" (#351)"

This reverts commit 367e43a5ed.

* use any backend protocol

* Reapply "chore(deepagents): refactor backend method names - `lsInfo` -> `ls`, …" (#349) (#356)

This reverts commit 573479d743.

* Reapply "chore(sdk): unify sync subagents and async subagents into a single pr…" (#348) (#355)

This reverts commit 96dc34ccb6.

* chore: align alpha with main (#358)

* fix(deepagents): remove orphaned ToolMessages for Gemini compatibility (#335)

* fix(deepagents): remove orphaned ToolMessages for Gemini compatibility

* Fix ToolMessages for Gemini compatibility

---------

Co-authored-by: Christian Bromann <git@bromann.dev>

* fix(deepagents): throw on built-in tool collision (#330)

* add error

* Create big-horses-fail.md

* add config error class

* cr

---------

Co-authored-by: Christian Bromann <git@bromann.dev>

* fix(deepagents): use `crypto.randomUUID()` instead of uuid (#336)

* fix(deepagents): use crypto.randomUUID() instead of uuid

* update pnpm-lock

* Create grumpy-weeks-wave.md

* Update libs/deepagents/src/middleware/fs.int.test.ts

* feat(deepagent): add LangSmithSandbox (#324)

* feat(deepagent): add LangSmithSandbox

* Change deepagents version from patch to minor

* format

* fix tests

* format

* make it a patch

* cr

* cr

* fix

* cr

* chore: version packages (#321)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

* regen lockfile

* fix langsmith tests so that they use backend protocol v2 methods

* format

---------

Co-authored-by: pawel-twardziak <pawel.twardziak.dev@gmail.com>
Co-authored-by: Christian Bromann <git@bromann.dev>
Co-authored-by: Maahir Sachdev <maahir.sachdev@langchain.dev>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

* feat(deepagents): add completion notifier middleware for async subagents (#334)

Port of langchain-ai/deepagents#2119 to TypeScript. Adds a
createCompletionNotifierMiddleware that async subagents can use to
proactively notify their supervisor when they complete or error,
closing the gap where the supervisor only learns about completion
when someone calls check_async_task.

- New createCompletionNotifierMiddleware with afterAgent and
  wrapModelCall hooks
- Uses @langchain/langgraph-sdk Client to send runs.create() to the
  supervisor's thread
- Reads parent_thread_id from subagent state (injected by
  start_async_task)
- Derives task_id from runtime.configurable.thread_id
- Silently no-ops if parent context is missing
- Guards against duplicate notifications
- 22 unit tests covering all hooks, edge cases, and error paths

fix(deepagents): make url required in completion notifier (no ASGI in JS)

JS does not have ASGI transport like Python, so the url parameter
must be provided explicitly. Removed all ASGI references from docs
and the localhost fallback default.

fix(deepagents): throw on built-in tool collision (#330)

* add error

* Create big-horses-fail.md

* add config error class

* cr

---------

Co-authored-by: Christian Bromann <git@bromann.dev>

fix(deepagents): use `crypto.randomUUID()` instead of uuid (#336)

* fix(deepagents): use crypto.randomUUID() instead of uuid

* update pnpm-lock

* Create grumpy-weeks-wave.md

* Update libs/deepagents/src/middleware/fs.int.test.ts

feat(deepagent): add LangSmithSandbox (#324)

* feat(deepagent): add LangSmithSandbox

* Change deepagents version from patch to minor

* format

* fix tests

* format

* make it a patch

* cr

* cr

* fix

* cr

regen lockfile

linting

linting

add missing url property

chore: version packages (#321)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

changeset

regen lockfil

* chore: enter alpha pre-release

* chore: target alpha for releases

* chore: version packages (alpha) (#359)

Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>

* chore(deepagents): extend supported backend file types (#363)

* extend supported file types

* Create strong-tigers-share.md

---------

Co-authored-by: Hunter Lovell <40191806+hntrl@users.noreply.github.com>

* chore(deepagents): implement async subagents + use stream example (#360)

* async subagents + use stream example

* fix lockfile

* format

* linting

* readme and linting

* format

* proactively send responses when subagents complete

* better examples

* feat(deepagents): rename completion notifier to completion callback and align with Python (#361)

* feat(deepagents): rename completion notifier to completion callback and align with Python PR

- Rename completion_notifier.ts -> completion_callback.ts to match Python's
  completion_callback.py naming
- Rename exports: createCompletionNotifierMiddleware -> createCompletionCallbackMiddleware,
  CompletionNotifierOptions -> CompletionCallbackOptions
- Rename state key: parent_thread_id -> callbackThreadId, option: parentGraphId -> callbackGraphId
- Make url optional (Python allows omitting for ASGI transport)
- Match Python's strict error behavior: throw on empty messages, non-AIMessage types,
  and missing callbackThreadId
- Add truncation suffix with task_id hint for long messages
- Use generic error message in wrapModelCall (don't leak error details)
- Remove duplicate notification guard (Python notifies on every error)
- Add extractCallbackContext to async_subagents.ts: injects callbackThreadId
  into subagent input state when launching via start_async_task
- Add tests for extractCallbackContext and callback context injection

* cr

* Rename completion notifier to completion callback

Renamed completion notifier to completion callback for consistency with Python.

* fix(sdk): `AsyncTask` `updatedAt` field doesn't update on task status changes (#400)

* update updatedAt field to change on any task update

* added changeset

* chore: set up self hosted async subagent example (#399)

* self hosted async subagent example

* with postgres

* formatting

* eslint disable no console

* fix dockerfile and readme

* Update examples/async-subagent-server/server.ts

Co-authored-by: Christian Bromann <git@bromann.dev>

---------

Co-authored-by: Christian Bromann <git@bromann.dev>

* chore(sdk): update async subagent middleware for agent protocol (#394)

* update async subagent middleware for agent protocol

* add changeset

* Update libs/deepagents/src/middleware/async_subagents.ts

Co-authored-by: Hunter Lovell <40191806+hntrl@users.noreply.github.com>

* Update libs/deepagents/src/middleware/async_subagents.ts

Co-authored-by: Hunter Lovell <40191806+hntrl@users.noreply.github.com>

* Update libs/deepagents/src/middleware/async_subagents.ts

Co-authored-by: Hunter Lovell <40191806+hntrl@users.noreply.github.com>

* differentiate agent protocol

---------

Co-authored-by: Hunter Lovell <40191806+hntrl@users.noreply.github.com>

* chore(repo): migrate linting and formatting to oxc tooling (#391)

* chore(repo): migrate linting and formatting to oxc tooling

* cr

* cr

* chore(lint): clean up console disables for oxlint

* cr

* Apply suggestions from code review

Co-authored-by: Christian Bromann <git@bromann.dev>

---------

Co-authored-by: Christian Bromann <git@bromann.dev>

* refactor(deepagents): clean up createDeepAgent middleware wiring (#392)

* refactor(deepagents): clean up createDeepAgent middleware wiring

* fix(deepagents): avoid duplicate HITL middleware on subagents

* add comments, remove iife

* Create ten-masks-flow.md

* fix(deepagents): align prompt templates with runtime behavior (#393)

* fix(deepagents): align prompt templates with runtime behavior

* chore: add changeset for prompt alignment fixes

* cr

* cr

* fix store backend and tests

* lint

* fix rests and resolveBackend

* lint

* fix failing tests

* revert adapt resolve backend

* fix resolve backend

* better variable name

* fix backend factory to return a maybe promise

* mark resolve backend as internal

* format

---------

Co-authored-by: Colin Francis <131073567+colifran@users.noreply.github.com>
Co-authored-by: pawel-twardziak <pawel.twardziak.dev@gmail.com>
Co-authored-by: Christian Bromann <git@bromann.dev>
Co-authored-by: Maahir Sachdev <maahir.sachdev@langchain.dev>
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
Co-authored-by: Colin Francis <colin.francis@langchain.dev>
2026-04-01 17:10:16 -07:00
Colin Francis 03ea1c9729 revert: "feat(deepagents): support multimodal files for backends (#298)" (#352)
* Revert "feat(deepagents): support multimodal files for backends (#298)"

This reverts commit aab678ad66.

* regen lock file

* fix empty string id check for sandbox protocols
2026-03-23 14:48:00 -07:00
Colin Francis 573479d743 Revert "chore(deepagents): refactor backend method names - lsInfo -> ls, …" (#349)
This reverts commit a5ba74eac2.
2026-03-23 13:46:06 -07:00
dependabot[bot] 0bc3efec28 build(deps-dev): bump tsdown from 0.20.3 to 0.21.4 (#343)
Bumps [tsdown](https://github.com/rolldown/tsdown) from 0.20.3 to 0.21.4.
- [Release notes](https://github.com/rolldown/tsdown/releases)
- [Commits](https://github.com/rolldown/tsdown/compare/v0.20.3...v0.21.4)

---
updated-dependencies:
- dependency-name: tsdown
  dependency-version: 0.21.4
  dependency-type: direct:development
  update-type: version-update:semver-minor
...

Signed-off-by: dependabot[bot] <support@github.com>
Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com>
2026-03-23 13:01:21 -07:00
Colin Francis a5ba74eac2 chore(deepagents): refactor backend method names - lsInfo -> ls, grepRaw -> grep, globInfo -> glob (#318)
* update backend protocol interface, types, and utils

* refactor state backend

* refactor store backend

* clean up

* unit tests

* refactor filesystem

* unit tests

* skip binary files in literal search for filesystem backend

* refactor base sandbox

* base sandbox unit tests

* refactor local shell backend

* refactor composite backend

* composite and local shell backend changes

* refactor fs middleware

* unit tests and fixed issue where createFileData was removed - this would be breaking

* refactor acp filesystem backend

* backend protocol v2

* simplify createFileData

* docstrings

* adapt backend protocol tests

* sandbox protocol v2

* format

* standard tests

* fix tests

* fix tests

* fix tests

* fix node vfs

* lint fix

* empty commit

* fix download files to handle binary

* any backend protocol

* lint

* make backend protocol v2 extend backend protocol

* make backend unknown type for is sandbox backend check

* add changeset

* add max binary file size

* add svg

* separate v1 and v2

* format

* lint

* format

* update glob, ls, read raw return types

* unit test fixes

* fix tests

* restore standard-tests package

* fix integ tests - make standard-tests backward compatible

* remove deleted sandbox adapter

* standard-test refactor for backwards compat

* linting

* fix tests

* type guards and improved guard checks

* store mime type with v2 file data

* make explicit v1 types

* fix locall shell int types

* fix bug

* edge case

* update providers

* lint

* fix repl

* read raw tests

* support string or unint8arrays

* clean comments, docstrings, and fix issue where we were throwing a string

* don't re-wrap uint8arrays

* clean up test names

* fix quickjs

* poison pill and uint8array issues

* add back video and audio support

* bump langgraph-checkpoint version for json plus serializer changes

* fix lock after merge with main

* remove explicit cast

* use instance of Uint8Array for FileDataV2 schema

* update changeset

* update backend protocol interface, types, and utils

* refactor state backend

* refactor store backend

* clean up

* unit tests

* refactor filesystem

* unit tests

* skip binary files in literal search for filesystem backend

* refactor base sandbox

* base sandbox unit tests

* refactor local shell backend

* refactor composite backend

* composite and local shell backend changes

* refactor fs middleware

* unit tests and fixed issue where createFileData was removed - this would be breaking

* refactor acp filesystem backend

* backend protocol v2

* simplify createFileData

* docstrings

* adapt backend protocol tests

* sandbox protocol v2

* format

* standard tests

* fix tests

* fix tests

* fix tests

* fix node vfs

* lint fix

* empty commit

* fix download files to handle binary

* any backend protocol

* lint

* make backend protocol v2 extend backend protocol

* make backend unknown type for is sandbox backend check

* add changeset

* add max binary file size

* add svg

* separate v1 and v2

* format

* lint

* format

* update glob, ls, read raw return types

* unit test fixes

* fix tests

* restore standard-tests package

* fix integ tests - make standard-tests backward compatible

* remove deleted sandbox adapter

* standard-test refactor for backwards compat

* linting

* fix tests

* type guards and improved guard checks

* store mime type with v2 file data

* make explicit v1 types

* fix locall shell int types

* fix bug

* edge case

* update providers

* lint

* fix repl

* read raw tests

* support string or unint8arrays

* clean comments, docstrings, and fix issue where we were throwing a string

* don't re-wrap uint8arrays

* clean up test names

* fix quickjs

* poison pill and uint8array issues

* add back video and audio support

* bump langgraph-checkpoint version for json plus serializer changes

* fix lock after merge with main

* remove explicit cast

* use instance of Uint8Array for FileDataV2 schema

* refactor backend methods

* add changeset

* changesets

* regen lock
2026-03-17 19:17:35 -07:00
Colin Francis aab678ad66 feat(deepagents): support multimodal files for backends (#298)
* update backend protocol interface, types, and utils

* refactor state backend

* refactor store backend

* clean up

* unit tests

* refactor filesystem

* unit tests

* skip binary files in literal search for filesystem backend

* refactor base sandbox

* base sandbox unit tests

* refactor local shell backend

* refactor composite backend

* composite and local shell backend changes

* refactor fs middleware

* unit tests and fixed issue where createFileData was removed - this would be breaking

* refactor acp filesystem backend

* backend protocol v2

* simplify createFileData

* docstrings

* adapt backend protocol tests

* sandbox protocol v2

* format

* standard tests

* fix tests

* fix tests

* fix tests

* fix node vfs

* lint fix

* empty commit

* fix download files to handle binary

* any backend protocol

* lint

* make backend protocol v2 extend backend protocol

* make backend unknown type for is sandbox backend check

* add changeset

* add max binary file size

* add svg

* separate v1 and v2

* format

* lint

* format

* update glob, ls, read raw return types

* unit test fixes

* fix tests

* restore standard-tests package

* fix integ tests - make standard-tests backward compatible

* remove deleted sandbox adapter

* standard-test refactor for backwards compat

* linting

* fix tests

* fix integ test

* type guards and improved guard checks

* store mime type with v2 file data

* make explicit v1 types

* fix locall shell int types

* fix bug

* edge case

* update providers

* lint

* fix repl

* read raw tests

* support string or unint8arrays

* clean comments, docstrings, and fix issue where we were throwing a string

* don't re-wrap uint8arrays

* clean up test names

* fix quickjs

* poison pill and uint8array issues

* add back video and audio support

* bump langgraph-checkpoint version for json plus serializer changes

* fix lock after merge with main

* remove explicit cast

* use instance of Uint8Array for FileDataV2 schema

* update changeset

* regen lock
2026-03-17 19:06:04 -07:00
github-actions[bot] d4e81b58cc chore: version packages (#224)
Co-authored-by: github-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>
2026-02-18 12:46:01 -08:00
Christian Bromann a827af7be8 feat(standard-tests): make test suite framework-agnostic and publish as public package (#237)
* feat(standard-tests): make test suite framework-agnostic and publish as public package

Move @langchain/sandbox-standard-tests from internal/ to libs/ for
publishing. The test suite no longer hard-depends on Vitest — test-runner
primitives (describe, it, expect, beforeAll, afterAll) are supplied via
a `runner` config property, letting consumers use any framework.

A convenience sub-export at @langchain/sandbox-standard-tests/vitest
pre-fills the runner with Vitest primitives for zero-config usage.

* format

* no underscore

* adding copies of license files

* adding changesets

* add build step

* fix test
2026-02-18 12:14:01 -08:00