@framers/agentos-ext-github 0.8.0 → 0.10.0

package/dist/documents/links.js

@@ -1,7 +1,8 @@
 /**
  * @fileoverview The GitHub addresses a person pastes, read without a request: a repository, a folder or a file on
  * github.com, and a file on raw.githubusercontent.com. Any other address on GitHub's hosts is refused, so no form of a
- * GitHub address is read as another site's page; an address on any other host is not GitHub's.
+ * GitHub address is read as another site's page; an address on any other host is not GitHub's. A text is read as the
+ * URL standard reads an address, so every form a browser opens as a GitHub address is answered as one.
  * @module agentos-ext-github/documents/links
  */
 /** The hosts of GitHub's site, where a repository, a folder and a file are read. */
@@ -12,6 +13,13 @@ const RAW_HOST = 'raw.githubusercontent.com';
 const OTHER_HOSTS = new Set(['gist.github.com', 'api.github.com', 'codeload.github.com', 'uploads.github.com']);
 /** The domain under which GitHub serves its users' content: raw files, gists, release assets, avatars. */
 const CONTENT_DOMAIN = 'githubusercontent.com';
+/**
+ * The domain of GitHub Enterprise Cloud with data residency: each enterprise on a subdomain of its own, its API on
+ * `api.<subdomain>.ghe.com`
+ * (https://docs.github.com/en/enterprise-cloud@latest/admin/data-residency/about-github-enterprise-cloud-with-data-residency).
+ * Its repositories are not read here.
+ */
+const ENTERPRISE_DOMAIN = 'ghe.com';
 /** First path segments of github.com that name GitHub's own pages, never an account. */
 const SITE_PAGES = new Set([
     'about', 'account', 'apps', 'codespaces', 'collections', 'contact', 'copilot', 'customer-stories', 'dashboard',
@@ -23,8 +31,19 @@ const SITE_PAGES = new Set([
 const OWNER = /^[A-Za-z0-9][A-Za-z0-9_-]{0,99}$/;
 /** A repository's name: letters, digits, dots, dashes and underscores. */
 const REPO = /^[A-Za-z0-9._-]{1,100}$/;
-/** An address with a scheme and an authority (`https://`, `http://`, `git://`, `ssh://`), whatever the scheme. */
-const SCHEME = /^[A-Za-z][A-Za-z0-9+.-]*:\/\//;
+/**
+ * A scheme and the slashes before an address's host, as the URL standard reads them
+ * (https://url.spec.whatwg.org/#scheme-state), in any case: after `http`, `https`, `ws`, `wss` and `ftp`, special
+ * schemes, any run of `/` and `\`, none included (https://url.spec.whatwg.org/#special-authority-slashes-state); after
+ * `file`, two of them (https://url.spec.whatwg.org/#file-slash-state), and none when a third follows, since the host is
+ * then empty (https://url.spec.whatwg.org/#file-host-state) and the address names no host; after any other scheme
+ * (`git://`, `ssh://`), `//`.
+ */
+const AUTHORITY = /^(?:(?:https?|wss?|ftp):[/\\]*|file:[/\\]{2}(?![/\\])|(?!file:)[a-z][a-z0-9+.-]*:\/\/)/i;
+/** The characters the URL standard removes wherever they stand in an address: tab, line feed and carriage return. */
+const TAB_OR_NEWLINE = /[\t\n\r]/g;
+/** A white space character, as `String.prototype.trim` drops it. */
+const WHITE_SPACE = /\s/;
 /** An opaque address, such as `mailto:` or `javascript:`, which names no host. */
 const OPAQUE = /^[A-Za-z][A-Za-z0-9+-]*:/;
 /**
@@ -34,6 +53,12 @@ const OPAQUE = /^[A-Za-z][A-Za-z0-9+-]*:/;
  * no path and stays opaque.
  */
 const CREDENTIALS = /^[^/?#\s@]*@[^/?#\s]*\//;
+/**
+ * GitHub's namespaces of a branch's and a tag's full name, which its own Raw links write
+ * (`https://github.com/cli/cli/raw/refs/tags/v2.0.0/README.md` for a file at the tag `v2.0.0`): the one form that tells
+ * a tag from a branch of the same name.
+ */
+const FULL_NAME = /^refs\/(?:heads|tags)\//;
 /** Git's address of a repository over SSH without a scheme: `git@github.com:<owner>/<repo>.git`. */
 const SCP = /^([A-Za-z0-9._-]+)@([^/:\s]+):(?!\/)(.*)$/;
 /** A refusal: the address is GitHub's, and names nothing read here. */
@@ -41,16 +66,38 @@ function refused() {
     return { kind: 'refused' };
 }
 /**
- * The address a text holds, read as its `https://` form: the scheme is dropped whatever it is, and a text without one
- * (`github.com/<owner>/<repo>`, `<user>:<password>@github.com/<owner>/<repo>`) is read as if it had it. Null for an
- * opaque address and for text that is no address.
+ * True for a character dropped around a pasted address: a C0 control or a space, as the URL standard drops them
+ * (https://url.spec.whatwg.org/#concept-basic-url-parser), or any other white space, as `String.prototype.trim` does.
+ */
+function isAround(code) {
+    return code <= 0x20 || WHITE_SPACE.test(String.fromCharCode(code));
+}
+/**
+ * A pasted text as the URL standard reads an address: without the C0 controls, spaces and other white space around it,
+ * and without any tab or newline within it. Read by a loop at each end, so a text of many such characters costs one
+ * pass.
+ */
+function cleaned(text) {
+    let start = 0;
+    let end = text.length;
+    while (start < end && isAround(text.charCodeAt(start)))
+        start += 1;
+    while (end > start && isAround(text.charCodeAt(end - 1)))
+        end -= 1;
+    return text.slice(start, end).replace(TAB_OR_NEWLINE, '');
+}
+/**
+ * The address a text holds, read as its `https://` form: the scheme and the slashes before the host are dropped
+ * whatever the scheme, and a text without one (`github.com/<owner>/<repo>`,
+ * `<user>:<password>@github.com/<owner>/<repo>`) is read as if it had it. Null for an opaque address (a scheme the URL
+ * standard does not treat as special, without `//`) and for text that is no address.
  */
 function addressOf(text) {
-    const scheme = SCHEME.exec(text);
-    if (scheme === null && OPAQUE.test(text) && !CREDENTIALS.test(text))
+    const authority = AUTHORITY.exec(text);
+    if (authority === null && OPAQUE.test(text) && !CREDENTIALS.test(text))
         return null;
     try {
-        return new URL(`https://${scheme === null ? text : text.slice(scheme[0].length)}`);
+        return new URL(`https://${authority === null ? text : text.slice(authority[0].length)}`);
     }
     catch {
         // Text that is no address; the parser's message would quote it.
@@ -68,9 +115,16 @@ function hostOf(host) {
         end -= 1;
     return host.slice(0, end).toLowerCase();
 }
-/** True for a host of GitHub's: its site, its raw files, its other hosts and the hosts of its users' content. */
+/** True for `domain` itself or a host under it. */
+function isUnder(host, domain) {
+    return host === domain || host.endsWith(`.${domain}`);
+}
+/**
+ * True for a host of GitHub's: its site, its raw files, its other hosts, the hosts of its users' content, and the
+ * hosts of GitHub Enterprise Cloud with data residency.
+ */
 function isGitHubHost(host) {
-    return SITE_HOSTS.has(host) || host === RAW_HOST || OTHER_HOSTS.has(host) || host === CONTENT_DOMAIN || host.endsWith(`.${CONTENT_DOMAIN}`);
+    return SITE_HOSTS.has(host) || host === RAW_HOST || OTHER_HOSTS.has(host) || isUnder(host, CONTENT_DOMAIN) || isUnder(host, ENTERPRISE_DOMAIN);
 }
 /**
  * An address's path as its segments, each decoded, without a trailing slash; null for a path with an empty segment
@@ -103,21 +157,29 @@ function hasControl(text) {
     return false;
 }
 /**
- * A folder's or a file's `<ref>/<path>` from the segments after `/tree/`, `/blob/` or `/raw/`, GitHub's own form of a
- * branch by its full name (`refs/heads/<branch>`) read as the branch. Null for none, for another kind of reference
- * (`refs/tags/`, `refs/pull/`), and for a text with an empty, `.` or `..` segment or a control character once decoded.
+ * A folder's or a file's `<ref>/<path>` from the segments after `/tree/`, `/blob/` or `/raw/`, a branch's or a tag's
+ * full name (`refs/heads/<branch>`, `refs/tags/<tag>`) kept whole. Null for none, for another kind of reference
+ * (`refs/pull/`, `refs/remotes/`) or a namespace with no name, and for a text with an empty, `.` or `..` segment or a
+ * control character once decoded.
  */
 function refAndPathOf(segments) {
-    let parts = segments;
-    if (parts[0] === 'refs') {
-        if (parts[1] !== 'heads' || parts.length < 3)
-            return null;
-        parts = parts.slice(2);
-    }
-    const text = parts.join('/');
+    const text = segments.join('/');
     if (text === '' || hasControl(text))
         return null;
-    return text.split('/').every((part) => part !== '' && part !== '.' && part !== '..') ? text : null;
+    const parts = text.split('/');
+    if (!parts.every((part) => part !== '' && part !== '.' && part !== '..'))
+        return null;
+    if (parts[0] === 'refs' && (parts.length < 3 || (parts[1] !== 'heads' && parts[1] !== 'tags')))
+        return null;
+    return text;
+}
+/**
+ * True for a ref and a path whose ref is followed by more of the text: a slash after the ref's name, the namespace of a
+ * full name aside. Where the ref ends is `resolveRef`'s to settle; a text without such a slash names a ref alone.
+ */
+function namesMore(refAndPath) {
+    const name = FULL_NAME.test(refAndPath) ? refAndPath.slice(refAndPath.indexOf('/', 'refs/'.length) + 1) : refAndPath;
+    return name.includes('/');
 }
 /** The owner and the repository of an address's first two segments, `.git` dropped; null when either is not one. */
 function repositoryOf(segments) {
@@ -143,9 +205,10 @@ function siteLink(segments) {
     const refAndPath = refAndPathOf(segments.slice(3));
     if (refAndPath === null)
         return refused();
-    const named = refAndPath.includes('/');
-    // GitHub shows the folder for a blob address that names a ref alone, and answers none for a raw one.
-    if (view === 'tree' || (view === 'blob' && !named))
+    const named = namesMore(refAndPath);
+    // GitHub redirects a blob address that names a ref alone by its short name to the folder, and answers 404 for one that
+    // names it by its full name and for a raw one.
+    if (view === 'tree' || (view === 'blob' && !named && !FULL_NAME.test(refAndPath)))
         return { kind: 'github_folder', ...repository, refAndPath };
     if (!named)
         return refused();
@@ -157,34 +220,45 @@ function rawLink(segments) {
         return refused();
     const repository = repositoryOf(segments);
     const refAndPath = refAndPathOf(segments.slice(2));
-    if (repository === null || refAndPath === null || !refAndPath.includes('/'))
+    if (repository === null || refAndPath === null || !namesMore(refAndPath))
         return refused();
     return { kind: 'github_file', ...repository, refAndPath, raw: true };
 }
 /**
  * What a GitHub address names, read without a request. Null for an address whose host is not GitHub's, and for text
  * that is no address; `refused` for an address on GitHub's hosts that names no repository, folder or file read here: an
- * account, an issue, a pull request, a wiki, a release, a commit, a tag, a gist, the API, an archive, GitHub's own
- * pages, an address that carries credentials (with a scheme or without one: `<user>:<password>@github.com/...`), and
- * a host other than github.com, www.github.com and raw.githubusercontent.com. The scheme (or its absence), a port, the
- * dots that end a host, `.git`, a trailing slash, a query and a fragment are ignored, and so is the `git` user of an
- * SSH address (`git@github.com:<owner>/<repo>.git`).
+ * account, an issue, a pull request, a wiki, a release, a commit, a reference that is neither a branch nor a tag
+ * (`refs/pull/<n>/head`), a gist, the API, an archive, GitHub's own pages, an address that carries credentials (with a
+ * scheme or without one: `<user>:<password>@github.com/...`), a host of GitHub Enterprise Cloud with data residency
+ * (`<subdomain>.ghe.com`), and a host other than github.com, www.github.com and raw.githubusercontent.com. The scheme
+ * (or its absence), a port, the dots that end a host, `.git`, a trailing slash, a query and a fragment are ignored, and
+ * so is the `git` user of an SSH address (`git@github.com:<owner>/<repo>.git`).
+ *
+ * The text is read as the URL standard reads an address: the C0 controls and spaces around it, and any other white
+ * space there, are dropped, and every tab and newline in it; after `http`, `https`, `ws`, `wss` and `ftp` any run of
+ * `/` and `\` stands before the host, none included (`https:github.com/<owner>/<repo>`,
+ * `https:\\github.com\<owner>\<repo>`), as a browser opens such an address; after `file`, two of them; after any
+ * other scheme, `//`. A backslash in the path is a slash.
  *
  * A folder's and a file's ref and path are answered as one text, each segment decoded, since a branch name may hold a
- * slash; GitHub's form of a branch by its full name, `refs/heads/<branch>`, is read as the branch. A `/blob/` address
- * whose text has no slash names a ref alone and is a folder, as GitHub shows it (its `/blob/<ref>` redirects to
- * `/tree/<ref>`); one whose text has a slash is a file, which `resolveRef` may settle as a ref alone (an empty path).
+ * slash. A branch's or a tag's full name, `refs/heads/<branch>` or `refs/tags/<tag>`, the form GitHub's own Raw links
+ * write, stays whole in it, so `resolveRef` reads the name among the branches or the tags alone: the full name is the
+ * one form that tells a tag from a branch of the same name, or a branch from a longer tag beside it (the branch
+ * `release` and the tag `release/2.0`). A `/blob/` address whose text has no slash names a ref alone and is a folder,
+ * as GitHub shows it (its `/blob/<ref>` redirects to `/tree/<ref>`); one whose text has a slash is a file, which
+ * `resolveRef` may settle as a ref alone (an empty path). A full name with nothing after it under `/blob/` or `/raw/`
+ * names no file, as GitHub answers it 404, and is refused.
  *
- * @param text The address as pasted; spaces around it are dropped.
+ * @param text The address as pasted; the controls and spaces around it are dropped.
  * @throws TypeError when `text` is not a string.
  */
 export function parseGitHubLink(text) {
     if (typeof text !== 'string')
         throw new TypeError('a link is a string');
-    const trimmed = text.trim();
-    if (trimmed === '')
+    const pasted = cleaned(text);
+    if (pasted === '')
         return null;
-    const scp = SCP.exec(trimmed);
+    const scp = SCP.exec(pasted);
     if (scp !== null) {
         const host = hostOf(scp[2]);
         if (!isGitHubHost(host))
@@ -195,7 +269,7 @@ export function parseGitHubLink(text) {
         const segments = address === null ? null : segmentsOf(address.pathname);
         return segments === null ? refused() : siteLink(segments);
     }
-    const address = addressOf(trimmed);
+    const address = addressOf(pasted);
     if (address === null)
         return null;
     const host = hostOf(address.hostname);

package/dist/documents/links.js.map

@@ -1 +1 @@
-{"version":3,"file":"links.js","sourceRoot":"","sources":["../../src/documents/links.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"links.js","sourceRoot":"","sources":["../../src/documents/links.ts"],"names":[],"mappings":"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"}

package/dist/documents/tree.d.ts

@@ -1,7 +1,8 @@
 /**
  * @fileoverview A repository's tree at a commit, read within a request budget, and the filter that keeps its
  * documentation. GitHub cuts a recursive tree past 100,000 entries or 7 MB and marks it `truncated`; such a tree is
- * read again one subtree at a time, and a level GitHub cuts short even when asked for alone is refused whole.
+ * read again one subtree at a time, a folder's files by the folders on its path alone, and a level GitHub cuts short
+ * even when asked for alone is refused whole.
  * @module agentos-ext-github/documents/tree
  */
 /** One file of a tree: its path from the repository's root, its blob and its size in bytes. */
@@ -77,23 +78,40 @@ export declare class TreeTooLarge extends Error {
      */
     constructor(maxRequests: number, reason?: TreeTooLargeReason);
 }
-/** The budget of a tree read, the folders it never walks into, and its abort signal. */
+/** The budget of a tree read, the folders it never walks into, the folder or the file it reads, and its abort signal. */
 export interface ReadTreeOptions {
     /** At most this many requests ({@link DEFAULT_MAX_TREE_REQUESTS} when absent). */
     maxRequests?: number;
     /** Folders, by name, whose files are left out and which a read by subtree never requests. */
     skipFolders?: readonly string[];
+    /**
+     * A folder of the tree, or a file, by its path with no leading or trailing slash: the files at it or under it are
+     * read, and no others. When GitHub truncates the recursive tree, the folders on the path are asked for one at a time
+     * and the folder it names is read as a whole tree is, so the read costs the path's depth and the folder's own
+     * subtree, whatever lies beside it. The whole tree when absent or `''`.
+     */
+    path?: string;
     signal?: AbortSignal;
 }
 /** A file's extension with its dot, in lower case, or `''` when its name has none. */
 export declare function extensionOf(path: string): string;
 /**
- * Every file of a repository's tree at a commit (symbolic links aside). The tree is asked for recursively; when GitHub
- * answers it truncated, its top level is read and each subtree is asked for the same way, so only the parts too large
- * for one answer cost a request per folder. Each request counts against `maxRequests`, and the read throws
- * {@link TreeTooLarge} (`budget`) rather than make one more. A level GitHub answers truncated without recursion as well
- * throws {@link TreeTooLarge} (`truncated`) at that answer, before any folder under it is asked for: the tree answer's
- * `truncated` field can be set on any answer, and a part of the tree would leave out files that then read as removed.
+ * Every file of a repository's tree at a commit (symbolic links aside), or of the folder or the file `options.path`
+ * names. The tree is asked for recursively; when GitHub answers it truncated, its top level is read and each subtree is
+ * asked for the same way, so only the parts too large for one answer cost a request per folder. Each request counts
+ * against `maxRequests`, and the read throws {@link TreeTooLarge} (`budget`) rather than make one more. A level GitHub
+ * answers truncated without recursion as well throws {@link TreeTooLarge} (`truncated`) at that answer, before any
+ * folder under it is asked for: the tree answer's `truncated` field can be set on any answer, and a part of the tree
+ * would leave out files that then read as removed.
+ *
+ * With a `path`, the files at it or under it are answered. A truncated tree is then read by the folders on the path
+ * alone, each asked for without recursion, down to the folder the path names, which is read as above, or to the file:
+ * a small folder of a large repository costs the path's depth and its own subtree, never a request for a folder beside
+ * it. A level that does not name the path's next folder or file answers no file, unless GitHub cut that level short,
+ * which throws {@link TreeTooLarge} (`truncated`), since the name may stand past the cut; a level cut short that names
+ * it is read on, since the folder's own subtree is whole. A path through a skipped folder (one of its segments before
+ * the last, which may name a file) holds no file kept, so it answers no file before any request, whatever the tree; a
+ * read whose signal is already aborted throws {@link GitHubNoAnswer} (`cancelled`) there, as a request would.
  *
  * Name the repository by its id. A full name reads whatever repository holds that name when the tree is asked for: a
  * renamed repository's old name can be taken again, and an account's old login claimed by another account, which ends
@@ -105,10 +123,19 @@ export declare function extensionOf(path: string): string;
  * @param repository The repository's id, read at `/repositories/<id>`, or its full name, `owner/name`.
  * @param commit The commit whose tree is read.
  * @param apiBase GitHub's REST API, or a stand-in's address in tests.
- * @param options The request budget, the folders skipped and an abort signal.
- * @throws TypeError before any request when `repository` is a number that is not a positive integer.
+ * @param options The request budget, the folders skipped, the folder or the file read and an abort signal.
+ * @throws TypeError before any request when `repository` is a number that is not a positive integer, or `options.path`
+ * has an empty, `.` or `..` segment or is not text.
  */
 export declare function readTree(fetchImpl: typeof fetch, token: string, repository: number | string, commit: string, apiBase?: string, options?: ReadTreeOptions): Promise<TreeBlob[]>;
+/**
+ * The path of a folder or a file of a repository a caller names, checked: absent and `''` name the whole repository
+ * and answer `''`. A path with an empty, `.` or `..` segment (a leading or a trailing slash among them), and a value
+ * that is not text, throw a `TypeError` that quotes none of it.
+ */
+export declare function pathOf(path: unknown): string;
+/** The blobs at `path` or under it: a folder's files, or the one file it names; every blob for `''`. */
+export declare function withinPath<T extends TreeBlob>(blobs: readonly T[], path: string): T[];
 /**
  * The filter that keeps a tree's documentation: the extensions kept, and with `includeCode` the code extensions beside
  * them; nothing under a skipped folder, nothing past the size cap, at most `maxFiles`, in path order. With code asked
@@ -140,6 +167,12 @@ export interface PlanTreeOptions extends TreeFilter {
     maxCodeBytes?: number;
     /** The extensions, with their dot, of the files skipped as images ({@link IMAGE_EXTENSIONS} when absent). */
     imageExtensions?: readonly string[];
+    /**
+     * A folder of the tree, or a file, by its path with no leading or trailing slash: only the files at it or under it
+     * are planned, and `maxFiles` counts them alone, as a listing keeps them under the same `path`. The whole tree when
+     * absent or `''`; a path with an empty, `.` or `..` segment, or one that is not text, is a `TypeError`.
+     */
+    path?: string;
 }
 /**
  * `pathFilter`'s sibling: every file of a tree, in path order, with its outcome under the same filter, so a caller can
@@ -149,11 +182,12 @@ export interface PlanTreeOptions extends TreeFilter {
  * (`count`, the documentation keeping its places first and the code taking the room left, as in `pathFilter`). A file
  * whose extension the filter's `extensions` names is documentation, an image's included; while code is asked for, one
  * of a code extension keeps `maxCodeBytes` as its bound, as a code file a tool wrote is left out whatever `extensions`
- * names. Each answer is a new object holding the file's `path`, `sha` and `size` and its `outcome`.
+ * names. Each answer is a new object holding the file's `path`, `sha` and `size` and its `outcome`. With a `path`, only
+ * the files of that folder, or the one file it names, are planned, and counted alone.
  *
  * @param blobs The files of a tree, as `readTree` answers them.
- * @param options The filter, the code bound and the image extensions.
- * @throws TypeError when `maxCodeBytes` is not a non-negative integer.
+ * @param options The filter, the code bound, the image extensions and the folder.
+ * @throws TypeError when `maxCodeBytes` is not a non-negative integer, or `path` is not a path.
  */
 export declare function planTree(blobs: readonly TreeBlob[], options?: PlanTreeOptions): PlannedBlob[];
 //# sourceMappingURL=tree.d.ts.map

package/dist/documents/tree.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../src/documents/tree.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../src/documents/tree.ts"],"names":[],"mappings":"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"}

package/dist/documents/tree.js

@@ -1,10 +1,11 @@
 /**
  * @fileoverview A repository's tree at a commit, read within a request budget, and the filter that keeps its
  * documentation. GitHub cuts a recursive tree past 100,000 entries or 7 MB and marks it `truncated`; such a tree is
- * read again one subtree at a time, and a level GitHub cuts short even when asked for alone is refused whole.
+ * read again one subtree at a time, a folder's files by the folders on its path alone, and a level GitHub cuts short
+ * even when asked for alone is refused whole.
  * @module agentos-ext-github/documents/tree
  */
-import { arrayOf, GITHUB_API_BASE, githubFetch, objectOf, repositoryPath, stringIn } from '../app/http.js';
+import { arrayOf, GITHUB_API_BASE, githubFetch, GitHubNoAnswer, objectOf, repositoryPath, stringIn } from '../app/http.js';
 /** The documentation kept by default: Markdown, text, reStructuredText, HTML, PDF and Word files. */
 export const DOCUMENT_EXTENSIONS = ['.md', '.markdown', '.txt', '.rst', '.html', '.htm', '.pdf', '.docx'];
 /** The folders skipped by default: dependencies, build output and vendored code. */
@@ -89,12 +90,22 @@ function inSkippedFolder(path, skip) {
     return path.split('/').slice(0, -1).some((folder) => skip.has(folder));
 }
 /**
- * Every file of a repository's tree at a commit (symbolic links aside). The tree is asked for recursively; when GitHub
- * answers it truncated, its top level is read and each subtree is asked for the same way, so only the parts too large
- * for one answer cost a request per folder. Each request counts against `maxRequests`, and the read throws
- * {@link TreeTooLarge} (`budget`) rather than make one more. A level GitHub answers truncated without recursion as well
- * throws {@link TreeTooLarge} (`truncated`) at that answer, before any folder under it is asked for: the tree answer's
- * `truncated` field can be set on any answer, and a part of the tree would leave out files that then read as removed.
+ * Every file of a repository's tree at a commit (symbolic links aside), or of the folder or the file `options.path`
+ * names. The tree is asked for recursively; when GitHub answers it truncated, its top level is read and each subtree is
+ * asked for the same way, so only the parts too large for one answer cost a request per folder. Each request counts
+ * against `maxRequests`, and the read throws {@link TreeTooLarge} (`budget`) rather than make one more. A level GitHub
+ * answers truncated without recursion as well throws {@link TreeTooLarge} (`truncated`) at that answer, before any
+ * folder under it is asked for: the tree answer's `truncated` field can be set on any answer, and a part of the tree
+ * would leave out files that then read as removed.
+ *
+ * With a `path`, the files at it or under it are answered. A truncated tree is then read by the folders on the path
+ * alone, each asked for without recursion, down to the folder the path names, which is read as above, or to the file:
+ * a small folder of a large repository costs the path's depth and its own subtree, never a request for a folder beside
+ * it. A level that does not name the path's next folder or file answers no file, unless GitHub cut that level short,
+ * which throws {@link TreeTooLarge} (`truncated`), since the name may stand past the cut; a level cut short that names
+ * it is read on, since the folder's own subtree is whole. A path through a skipped folder (one of its segments before
+ * the last, which may name a file) holds no file kept, so it answers no file before any request, whatever the tree; a
+ * read whose signal is already aborted throws {@link GitHubNoAnswer} (`cancelled`) there, as a request would.
  *
  * Name the repository by its id. A full name reads whatever repository holds that name when the tree is asked for: a
  * renamed repository's old name can be taken again, and an account's old login claimed by another account, which ends
@@ -106,15 +117,23 @@ function inSkippedFolder(path, skip) {
  * @param repository The repository's id, read at `/repositories/<id>`, or its full name, `owner/name`.
  * @param commit The commit whose tree is read.
  * @param apiBase GitHub's REST API, or a stand-in's address in tests.
- * @param options The request budget, the folders skipped and an abort signal.
- * @throws TypeError before any request when `repository` is a number that is not a positive integer.
+ * @param options The request budget, the folders skipped, the folder or the file read and an abort signal.
+ * @throws TypeError before any request when `repository` is a number that is not a positive integer, or `options.path`
+ * has an empty, `.` or `..` segment or is not text.
  */
 export async function readTree(fetchImpl, token, repository, commit, apiBase = GITHUB_API_BASE, options = {}) {
     const address = `${apiBase}/${repositoryPath(repository)}`;
+    const target = pathOf(options.path);
     const maxRequests = options.maxRequests ?? DEFAULT_MAX_TREE_REQUESTS;
     const skip = new Set(options.skipFolders ?? []);
     const blobs = [];
     let requests = 0;
+    // A path through a skipped folder holds no file kept, so no level, whole or cut short, is asked for.
+    if (inSkippedFolder(target, skip)) {
+        if (options.signal?.aborted === true)
+            throw new GitHubNoAnswer('cancelled');
+        return blobs;
+    }
     const read = async (sha, recursive) => {
         if (requests >= maxRequests)
             throw new TreeTooLarge(maxRequests);
@@ -149,13 +168,73 @@ export async function readTree(fetchImpl, token, repository, commit, apiBase = G
             }
         }
     };
-    await walk(commit, '');
+    /**
+     * The files at `target` or under it: the tree asked for recursively once, and, when GitHub cuts it short, each folder
+     * on the path asked for alone down to the folder the path names, which `walk` reads, or to the file.
+     */
+    const within = async () => {
+        const whole = await read(commit, true);
+        if (!whole.truncated) {
+            const folder = `${target}/`;
+            for (const entry of whole.entries)
+                if (entry.path === target || entry.path.startsWith(folder))
+                    keep(entry, entry.path);
+            return;
+        }
+        const names = target.split('/');
+        let sha = commit;
+        let prefix = '';
+        for (const [index, name] of names.entries()) {
+            const level = await read(sha, false);
+            const entry = level.entries.find((candidate) => candidate.path === name);
+            // A level cut short may hold the name past its cut; one read whole holds every name it has.
+            if (entry === undefined) {
+                if (level.truncated)
+                    throw new TreeTooLarge(maxRequests, 'truncated');
+                return;
+            }
+            if (entry.type !== 'tree') {
+                if (index === names.length - 1)
+                    keep(entry, `${prefix}${name}`);
+                return;
+            }
+            if (skip.has(name))
+                return;
+            sha = entry.sha;
+            prefix = `${prefix}${name}/`;
+        }
+        await walk(sha, prefix);
+    };
+    if (target === '')
+        await walk(commit, '');
+    else
+        await within();
     return blobs;
 }
 /** Blobs in path order. */
 function byPath(a, b) {
     return a.path < b.path ? -1 : a.path > b.path ? 1 : 0;
 }
+/**
+ * The path of a folder or a file of a repository a caller names, checked: absent and `''` name the whole repository
+ * and answer `''`. A path with an empty, `.` or `..` segment (a leading or a trailing slash among them), and a value
+ * that is not text, throw a `TypeError` that quotes none of it.
+ */
+export function pathOf(path) {
+    if (path === undefined || path === '')
+        return '';
+    if (typeof path !== 'string' || path.split('/').some((segment) => segment === '' || segment === '.' || segment === '..')) {
+        throw new TypeError('a path is text with no empty, . or .. segment');
+    }
+    return path;
+}
+/** The blobs at `path` or under it: a folder's files, or the one file it names; every blob for `''`. */
+export function withinPath(blobs, path) {
+    if (path === '')
+        return [...blobs];
+    const folder = `${path}/`;
+    return blobs.filter((blob) => blob.path === path || blob.path.startsWith(folder));
+}
 /**
  * The filter that keeps a tree's documentation: the extensions kept, and with `includeCode` the code extensions beside
  * them; nothing under a skipped folder, nothing past the size cap, at most `maxFiles`, in path order. With code asked
@@ -187,16 +266,18 @@ export function pathFilter(filter = {}) {
  * (`count`, the documentation keeping its places first and the code taking the room left, as in `pathFilter`). A file
  * whose extension the filter's `extensions` names is documentation, an image's included; while code is asked for, one
  * of a code extension keeps `maxCodeBytes` as its bound, as a code file a tool wrote is left out whatever `extensions`
- * names. Each answer is a new object holding the file's `path`, `sha` and `size` and its `outcome`.
+ * names. Each answer is a new object holding the file's `path`, `sha` and `size` and its `outcome`. With a `path`, only
+ * the files of that folder, or the one file it names, are planned, and counted alone.
  *
  * @param blobs The files of a tree, as `readTree` answers them.
- * @param options The filter, the code bound and the image extensions.
- * @throws TypeError when `maxCodeBytes` is not a non-negative integer.
+ * @param options The filter, the code bound, the image extensions and the folder.
+ * @throws TypeError when `maxCodeBytes` is not a non-negative integer, or `path` is not a path.
  */
 export function planTree(blobs, options = {}) {
     if (options.maxCodeBytes !== undefined && !(Number.isSafeInteger(options.maxCodeBytes) && options.maxCodeBytes >= 0)) {
         throw new TypeError('maxCodeBytes is a number of bytes: a non-negative integer');
     }
+    const path = pathOf(options.path);
     const documents = new Set((options.extensions ?? DOCUMENT_EXTENSIONS).map((extension) => extension.toLowerCase()));
     const codeAsked = options.includeCode === true;
     const code = new Set(CODE_EXTENSIONS);
@@ -205,7 +286,9 @@ export function planTree(blobs, options = {}) {
     const maxFiles = options.maxFiles ?? DEFAULT_MAX_FILES;
     const maxFileBytes = options.maxFileBytes ?? DEFAULT_MAX_FILE_BYTES;
     const maxCodeBytes = Math.min(options.maxCodeBytes ?? maxFileBytes, maxFileBytes);
-    const planned = [...blobs].sort(byPath).map((blob) => ({ path: blob.path, sha: blob.sha, size: blob.size, outcome: 'note' }));
+    const planned = withinPath(blobs, path)
+        .sort(byPath)
+        .map((blob) => ({ path: blob.path, sha: blob.sha, size: blob.size, outcome: 'note' }));
     const documentation = [];
     const sources = [];
     for (const blob of planned) {