ContextHubBackend

Hub agent repo, as "owner/name" or "-/name".

LangSmith client. Defaults to Client().

Return linked-entry paths mapped to their repo handles.

Return True if the hub repo already exists with at least one commit.

Read file content for the requested line range.

Commit content to file_path.

Replace old_string with new_string in a file.

Delete a file or directory by committing its removal from the hub repo.

Deleting a path removes the exact file plus every nested entry under it (the prefix file_path + "/"), so a directory is removed recursively.

List immediate files and subdirectories under path (non-recursive).

Search contents for pattern (optional path / glob filters).

The glob filter uses fnmatch semantics and does not follow the shared include-glob contract that glob() on this class uses: * crosses /, and matching is case-normalized. Do not assume the two agree on a given pattern.

When max_count is set, at most that many matches are returned; if more exist the search stops and the result is flagged truncated=True. Exactly max_count matches with none dropped is reported complete (truncated=False).

Return files matching pattern (path unused — flat namespace).

Matching uses the shared backend contract (compile_grep_include_glob), so a bare pattern matches the basename at any depth, a pattern with / matches the namespace-relative path, and a leading / anchors. Plain fnmatch would diverge on all three: its * crosses /, so /*.py would widen to every depth instead of anchoring to the top level.

Upload text files in one commit; non-UTF-8 inputs rejected per file.

Download files as raw bytes. Missing paths return file_not_found.