@exla/rudder 5.0.11 → 5.0.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (39) hide show
  1. package/cloud/package.json +7 -1
  2. package/dist/backends.js +22 -10
  3. package/dist/backends.js.map +1 -1
  4. package/dist/cloud.js +24 -4
  5. package/dist/cloud.js.map +1 -1
  6. package/dist/effort.js +1 -5
  7. package/dist/effort.js.map +1 -1
  8. package/dist/models.d.ts +19 -0
  9. package/dist/models.js +107 -3
  10. package/dist/models.js.map +1 -1
  11. package/dist/native/darwin-arm64/native-manifest.json +3 -3
  12. package/dist/native/darwin-arm64/rudder-native +0 -0
  13. package/dist/native/linux-x64/native-manifest.json +3 -3
  14. package/dist/native/linux-x64/rudder-native +0 -0
  15. package/dist/native-agents.js +19 -8
  16. package/dist/native-agents.js.map +1 -1
  17. package/dist/opencode.d.ts +13 -0
  18. package/dist/opencode.js +25 -0
  19. package/dist/opencode.js.map +1 -0
  20. package/dist/project-files/agent-notes.d.ts +40 -0
  21. package/dist/project-files/agent-notes.js +112 -0
  22. package/dist/project-files/agent-notes.js.map +1 -0
  23. package/dist/project-files/file-refs.d.ts +51 -0
  24. package/dist/project-files/file-refs.js +230 -0
  25. package/dist/project-files/file-refs.js.map +1 -0
  26. package/dist/project-files/home.d.ts +5 -1
  27. package/dist/project-files/home.js +27 -16
  28. package/dist/project-files/home.js.map +1 -1
  29. package/dist/project-files/service.d.ts +5 -1
  30. package/dist/project-files/service.js +3 -3
  31. package/dist/project-files/service.js.map +1 -1
  32. package/dist/run-manager.js +1 -2
  33. package/dist/run-manager.js.map +1 -1
  34. package/dist/util.js +1 -0
  35. package/dist/util.js.map +1 -1
  36. package/package.json +1 -1
  37. package/dist/project-files/notes.d.ts +0 -64
  38. package/dist/project-files/notes.js +0 -212
  39. package/dist/project-files/notes.js.map +0 -1
@@ -0,0 +1,112 @@
1
+ import { constants } from "node:fs";
2
+ import { lstat, open, realpath } from "node:fs/promises";
3
+ import { createHash } from "node:crypto";
4
+ import path from "node:path";
5
+ import { FILE_LIMITS, ProjectFileError, ProjectFileService } from "./service.js";
6
+ /** One agent's notes: notes.md in its run folder (.rudder/runs/<id>/) on the
7
+ * home, next to its run.json. Only the user writes them, from the app's Notes
8
+ * editor for that chat. Agents are not told about them and nothing else in
9
+ * Rudder writes them.
10
+ *
11
+ * The run folder is the agent's own state, so the notes stay with the row
12
+ * through a rename, a workspace move or a harness switch (all keep the run
13
+ * id), and go when the agent is deleted (remove_native_run_record removes the
14
+ * folder). `.rudder/` is in every project's local Git exclude, so the notes
15
+ * never show up to commit.
16
+ *
17
+ * Reads and saves go through ProjectFileService, narrowed to this one file:
18
+ * a symlink or anything but a regular file is refused, and a save is swapped
19
+ * in by rename only while the file still holds the revision the editor loaded,
20
+ * so two devices never overwrite each other silently. A missing file reads as
21
+ * empty; the first save creates it.
22
+ */
23
+ export const NOTES_FILE = "notes.md";
24
+ const SCOPE = { projectId: "notes", workspaceId: "notes", attemptId: "notes", ownerEpoch: 0 };
25
+ const RUN_ID = /^[A-Za-z0-9._-]{1,256}$/;
26
+ const REVISION = /^[a-f0-9]{64}$/;
27
+ const CONTROL = /[\x00-\x08\x0b\x0c\x0e-\x1f]/;
28
+ /** The one entry point of the home RPC, for a project directory the home chose. */
29
+ export async function agentNotes(projectDir, runId, request) {
30
+ if (request?.version !== 1)
31
+ throw new ProjectFileError("invalid", "Unsupported notes request");
32
+ const root = await runFolder(projectDir, runId);
33
+ if (request.operation === "read")
34
+ return readNotes(root);
35
+ if (request.operation !== "write")
36
+ throw new ProjectFileError("invalid", "Unsupported notes request");
37
+ const { baseRevision, text } = request;
38
+ if (!(baseRevision === null || (typeof baseRevision === "string" && REVISION.test(baseRevision))) || typeof text !== "string") {
39
+ throw new ProjectFileError("invalid", "Invalid notes save");
40
+ }
41
+ if (Buffer.byteLength(text) > FILE_LIMITS.writeBytes)
42
+ throw new ProjectFileError("large", "Notes over 1 MiB cannot be saved here");
43
+ if (CONTROL.test(text))
44
+ throw new ProjectFileError("invalid", "The text contains control characters");
45
+ return baseRevision === null ? createNotes(root, text) : saveNotes(root, baseRevision, text);
46
+ }
47
+ /** The agent's run folder. Notes belong to an agent that exists: its run.json is there. */
48
+ async function runFolder(projectDir, runId) {
49
+ if (typeof runId !== "string" || !RUN_ID.test(runId) || runId === "." || runId === "..")
50
+ throw new ProjectFileError("invalid", "Not an agent id");
51
+ const dir = path.join(projectDir, ".rudder", "runs", runId);
52
+ try {
53
+ if ((await lstat(path.join(dir, "run.json"))).isFile())
54
+ return await realpath(dir);
55
+ }
56
+ catch (error) {
57
+ if (error.code !== "ENOENT")
58
+ throw error;
59
+ }
60
+ throw new ProjectFileError("missing", "That agent is not on your cloud machine");
61
+ }
62
+ const files = (root) => new ProjectFileService(async () => ({ scope: SCOPE, root, access: { kind: "host" }, only: NOTES_FILE }));
63
+ const missing = (error) => error instanceof ProjectFileError && error.code === "missing";
64
+ async function readNotes(root) {
65
+ let doc;
66
+ try {
67
+ doc = await files(root).dispatch({ version: 1, operation: "read", scope: SCOPE, path: NOTES_FILE });
68
+ }
69
+ catch (error) {
70
+ if (missing(error))
71
+ return { text: "", revision: null };
72
+ throw error;
73
+ }
74
+ if (typeof doc.text !== "string")
75
+ throw new ProjectFileError("unsupported", `${NOTES_FILE} is not UTF-8 text`);
76
+ return { text: doc.text, revision: doc.revision };
77
+ }
78
+ async function saveNotes(root, baseRevision, text) {
79
+ let result;
80
+ try {
81
+ result = await files(root).dispatch({ version: 1, operation: "write", scope: SCOPE, path: NOTES_FILE, baseRevision, text });
82
+ }
83
+ catch (error) {
84
+ if (missing(error))
85
+ return { outcome: "conflict", ...(await readNotes(root)) };
86
+ throw error;
87
+ }
88
+ if ("outcome" in result && result.outcome === "saved")
89
+ return { outcome: "saved", revision: result.revision };
90
+ return { outcome: "conflict", ...(await readNotes(root)) };
91
+ }
92
+ /** The first save. Another device creating the file first is a conflict. */
93
+ async function createNotes(root, text) {
94
+ let file;
95
+ try {
96
+ file = await open(path.join(root, NOTES_FILE), constants.O_WRONLY | constants.O_CREAT | constants.O_EXCL | constants.O_NOFOLLOW, 0o644);
97
+ }
98
+ catch (error) {
99
+ if (error.code === "EEXIST")
100
+ return { outcome: "conflict", ...(await readNotes(root)) };
101
+ throw error;
102
+ }
103
+ try {
104
+ await file.writeFile(text);
105
+ await file.sync();
106
+ }
107
+ finally {
108
+ await file.close();
109
+ }
110
+ return { outcome: "saved", revision: createHash("sha256").update(text).digest("hex") };
111
+ }
112
+ //# sourceMappingURL=agent-notes.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"agent-notes.js","sourceRoot":"","sources":["../../src/project-files/agent-notes.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,51 @@
1
+ import { type FileGrant } from "./service.js";
2
+ import type { FileDocument, FileScope } from "./types.js";
3
+ /** A file a chat message names (cloud/app/file-refs.js): a Markdown link or
4
+ * inline code holding a path, opened read only beside the chat. Only the
5
+ * home's own account asks (cloud/src/project-files/file-refs.ts).
6
+ *
7
+ * A relative path is the agent's: it resolves against the agent's live
8
+ * workspace first, then the project checkout. A file inside a Linux overlay
9
+ * fork is read through the file service, which sees the agent's own mount.
10
+ * Any other file comes from the home's filesystem, when it is under one of
11
+ * the home user's folders, is a regular UTF-8 text file of at most 2 MB, and
12
+ * neither the path asked for nor the file it resolves to is on the deny list
13
+ * below. */
14
+ export declare const FILE_REF_LIMITS: {
15
+ readonly textBytes: number;
16
+ readonly pathChars: 4096;
17
+ };
18
+ export type FileRefRequest = {
19
+ version: 1;
20
+ runId: string;
21
+ path: string;
22
+ knownRevision?: string;
23
+ };
24
+ /** Where host files may come from, and the home folders whose hidden files are private. */
25
+ export type FileRefPolicy = {
26
+ /** `~` in a path. */
27
+ home: string;
28
+ /** The home user's home folders: HOME, and the volume folder its dotfiles link into on Cloud. */
29
+ homes: readonly string[];
30
+ /** Host files are read only under these. */
31
+ roots: readonly string[];
32
+ };
33
+ export type FileRefDependencies = {
34
+ /** The project's live file grants: its checkout, and each running agent's workspace. */
35
+ grants(signal: AbortSignal): Promise<FileGrant[]>;
36
+ /** Read through the file service, for a fork only its agent's mount holds. */
37
+ read(scope: FileScope, relative: string, knownRevision: string | undefined, signal: AbortSignal): Promise<FileDocument>;
38
+ policy: FileRefPolicy;
39
+ };
40
+ export declare const PRIVATE_FILE = "This file can hold keys or tokens, so the viewer does not open it";
41
+ export declare const SYSTEM_FILE = "System files do not open in the viewer";
42
+ /** `file` relative to `folder`, or null when it is not inside it. */
43
+ export declare function inside(folder: string, file: string): string | null;
44
+ /** Why the viewer does not open this absolute, normalized path, or null. */
45
+ export declare function privateReason(file: string, homes: readonly string[]): string | null;
46
+ /** Why a host file outside the home user's folders does not open, or null. */
47
+ export declare function outsideReason(file: string, roots: readonly string[]): string | null;
48
+ /** Read the file `request.path` names, as the chat's agent meant it. The
49
+ * document's `path` is the absolute path it resolved to: later reads (the
50
+ * viewer's refresh) ask for that. */
51
+ export declare function readFileRef(value: unknown, dependencies: FileRefDependencies, signal: AbortSignal): Promise<FileDocument>;
@@ -0,0 +1,230 @@
1
+ import { constants } from "node:fs";
2
+ import { lstat, open, realpath } from "node:fs/promises";
3
+ import path from "node:path";
4
+ import { classification, ProjectFileError, revisionOf, textOf } from "./service.js";
5
+ /** A file a chat message names (cloud/app/file-refs.js): a Markdown link or
6
+ * inline code holding a path, opened read only beside the chat. Only the
7
+ * home's own account asks (cloud/src/project-files/file-refs.ts).
8
+ *
9
+ * A relative path is the agent's: it resolves against the agent's live
10
+ * workspace first, then the project checkout. A file inside a Linux overlay
11
+ * fork is read through the file service, which sees the agent's own mount.
12
+ * Any other file comes from the home's filesystem, when it is under one of
13
+ * the home user's folders, is a regular UTF-8 text file of at most 2 MB, and
14
+ * neither the path asked for nor the file it resolves to is on the deny list
15
+ * below. */
16
+ export const FILE_REF_LIMITS = { textBytes: 2 * 1024 * 1024, pathChars: 4096 };
17
+ const CHECKOUT = "checkout";
18
+ const RUN_ID = /^[A-Za-z0-9._-]{1,256}$/;
19
+ const REVISION = /^[a-f0-9]{64}$/;
20
+ const CONTROL = /[\x00-\x1f\x7f]/;
21
+ // ---------- Deny list ----------
22
+ export const PRIVATE_FILE = "This file can hold keys or tokens, so the viewer does not open it";
23
+ export const SYSTEM_FILE = "System files do not open in the viewer";
24
+ const SYSTEM = ["/proc", "/sys", "/dev", "/run"];
25
+ /** Folders, at any depth, that hold keys, tokens or repository internals. */
26
+ const PRIVATE_FOLDERS = new Set([".ssh", ".gnupg", ".aws", ".azure", ".kube", ".docker", ".fly", ".gcloud", "gcloud",
27
+ ".password-store", "keyrings", ".terraform.d", ".git", ".jj", ".rudder", ".rudder-workspaces", ".rudder-worktrees"]);
28
+ /** Files, at any depth, that hold keys or tokens. */
29
+ const PRIVATE_NAMES = new Set([".npmrc", ".netrc", ".pypirc", ".git-credentials", ".credentials.json", "credentials",
30
+ "credentials.json", "credentials.toml", "auth.json", ".claude.json", "RUDDER_SHARED.md", ".vault-token", ".htpasswd", ".pgpass",
31
+ // Claude Code's local settings, in a project or a home folder, can hold API keys in `env`.
32
+ "settings.local.json"]);
33
+ // .env files, key files, SSH keys and shell or REPL histories (commands typed with tokens in them).
34
+ const PRIVATE_NAME = /^\.env(?:\.|$)|\.(?:pem|key|p12|pfx|jks|keystore|kdbx|ppk|gpg)$|^id_(?:rsa|dsa|ecdsa|ed25519)|^\.[\w.-]*history$|_history$/i;
35
+ /** The hidden folders of a home folder that open: agents keep plans, memory
36
+ * and instructions there. Every other hidden file or folder directly in a
37
+ * home folder (.config, .local, .bashrc, a token file) stays private. */
38
+ const OPEN_HOME_FOLDERS = new Set([".claude", ".codex"]);
39
+ /** Their settings, which can hold API keys (an `env` block, an MCP server's key). */
40
+ const HOME_SETTINGS = new Set([".claude/settings.json", ".codex/config.toml"]);
41
+ /** Inside those, anything named like a secret. */
42
+ const SECRET_LIKE = /(?:^|[._-])(?:auth|oauth|credentials?|secrets?|tokens?|passwords?|api[._-]?keys?|private[._-]?keys?)(?:[._-]|$)/i;
43
+ /** `file` relative to `folder`, or null when it is not inside it. */
44
+ export function inside(folder, file) {
45
+ if (file === folder)
46
+ return "";
47
+ const prefix = folder.endsWith("/") ? folder : `${folder}/`;
48
+ return file.startsWith(prefix) ? file.slice(prefix.length) : null;
49
+ }
50
+ /** Why the viewer does not open this absolute, normalized path, or null. */
51
+ export function privateReason(file, homes) {
52
+ if (SYSTEM.some((root) => inside(root, file) !== null))
53
+ return SYSTEM_FILE;
54
+ const parts = file.split("/").filter(Boolean);
55
+ if (parts.some((part) => PRIVATE_FOLDERS.has(part) || PRIVATE_NAMES.has(part) || PRIVATE_NAME.test(part)))
56
+ return PRIVATE_FILE;
57
+ for (const home of homes) {
58
+ const rest = inside(home, file);
59
+ if (!rest)
60
+ continue;
61
+ const [top, ...below] = rest.split("/");
62
+ if (top.startsWith(".") && !OPEN_HOME_FOLDERS.has(top))
63
+ return PRIVATE_FILE;
64
+ if (HOME_SETTINGS.has(rest))
65
+ return PRIVATE_FILE;
66
+ if (OPEN_HOME_FOLDERS.has(top) && below.some((part) => SECRET_LIKE.test(part)))
67
+ return PRIVATE_FILE;
68
+ }
69
+ return null;
70
+ }
71
+ /** Why a host file outside the home user's folders does not open, or null. */
72
+ export function outsideReason(file, roots) {
73
+ return roots.some((root) => inside(root, file) !== null) ? null : `Only files under ${roots.join(", ")} open in the viewer`;
74
+ }
75
+ // ---------- Reading ----------
76
+ const notText = () => new ProjectFileError("unsupported", "Only text files open in the viewer");
77
+ const tooLarge = () => new ProjectFileError("large", "This file is over 2 MB, too large to show here");
78
+ function validRequest(value) {
79
+ const request = value;
80
+ if (request?.version !== 1 || typeof request.runId !== "string" || !RUN_ID.test(request.runId)
81
+ || typeof request.path !== "string" || !request.path || request.path.length > FILE_REF_LIMITS.pathChars || CONTROL.test(request.path)
82
+ || (request.knownRevision !== undefined && !(typeof request.knownRevision === "string" && REVISION.test(request.knownRevision)))) {
83
+ throw new ProjectFileError("invalid", "Invalid file request");
84
+ }
85
+ return request;
86
+ }
87
+ /** Read the file `request.path` names, as the chat's agent meant it. The
88
+ * document's `path` is the absolute path it resolved to: later reads (the
89
+ * viewer's refresh) ask for that. */
90
+ export async function readFileRef(value, dependencies, signal) {
91
+ const request = validRequest(value);
92
+ const input = request.path;
93
+ const grants = await dependencies.grants(signal);
94
+ const places = [request.runId, CHECKOUT].map((id) => grants.find((grant) => grant.scope.workspaceId === id)).filter((grant) => !!grant);
95
+ const policy = await canonical(dependencies.policy);
96
+ let candidates;
97
+ if (input === "~" || input.startsWith("~/"))
98
+ candidates = [path.join(policy.home, input.slice(1))];
99
+ else if (path.isAbsolute(input))
100
+ candidates = [path.normalize(input)];
101
+ else
102
+ candidates = [...new Set(places.map((place) => path.resolve(place.root, input)))];
103
+ if (!candidates.length)
104
+ throw new ProjectFileError("denied", "This project's files are not available right now");
105
+ for (const [index, file] of candidates.entries()) {
106
+ try {
107
+ return await readAt(file, places, request.knownRevision, dependencies, policy, signal);
108
+ }
109
+ catch (error) {
110
+ if (!(error instanceof ProjectFileError && error.code === "missing"))
111
+ throw error;
112
+ if (index === candidates.length - 1)
113
+ throw new ProjectFileError("missing", `File not found: ${input}`);
114
+ }
115
+ }
116
+ throw new ProjectFileError("missing", `File not found: ${input}`);
117
+ }
118
+ /** The policy's folders, also as the paths they resolve to. */
119
+ async function canonical(policy) {
120
+ const both = async (folders) => [...new Set([...folders, ...await Promise.all(folders.map((folder) => realpath(folder)))])];
121
+ return { home: policy.home, homes: await both(policy.homes), roots: await both(policy.roots) };
122
+ }
123
+ async function readAt(file, places, knownRevision, dependencies, policy, signal) {
124
+ const reason = privateReason(file, policy.homes);
125
+ if (reason)
126
+ throw new ProjectFileError("denied", reason);
127
+ // A fork's files exist only in its agent's mount: the file service reads them there.
128
+ const fork = places.find((place) => place.access.kind === "namespace" && inside(place.root, file) !== null);
129
+ if (!fork)
130
+ return readHost(file, knownRevision, policy, signal);
131
+ const relative = inside(fork.root, file);
132
+ if (!relative)
133
+ throw new ProjectFileError("unsupported", "That is a folder. Only files open in the viewer");
134
+ let doc;
135
+ try {
136
+ doc = await dependencies.read(fork.scope, relative, knownRevision, signal);
137
+ }
138
+ catch (error) {
139
+ throw error instanceof ProjectFileError && error.code === "large" ? tooLarge() : error;
140
+ }
141
+ if (!["text", "markdown", "html"].includes(doc.kind))
142
+ throw notText();
143
+ if (typeof doc.text === "string" && Buffer.byteLength(doc.text) > FILE_REF_LIMITS.textBytes)
144
+ throw tooLarge();
145
+ return shown(file, doc.revision, doc.text, doc.unchanged === true);
146
+ }
147
+ /** Markdown previews; everything else shows as text with its syntax colored. */
148
+ function shown(file, revision, text, unchanged) {
149
+ const format = classification(file);
150
+ const kind = format.kind === "markdown" ? "markdown" : "text";
151
+ return unchanged ? { path: file, revision, mime: format.mime, kind, unchanged: true } : { path: file, revision, mime: format.mime, kind, text };
152
+ }
153
+ async function readHost(file, knownRevision, policy, signal) {
154
+ const check = (at) => {
155
+ const reason = outsideReason(at, policy.roots) ?? privateReason(at, policy.homes);
156
+ if (reason)
157
+ throw new ProjectFileError("denied", reason);
158
+ };
159
+ check(file);
160
+ let real;
161
+ let handle;
162
+ try {
163
+ // What the path names after every symlink is checked too: a link in a
164
+ // project never reaches a private file.
165
+ real = await realpath(file);
166
+ check(real);
167
+ handle = await open(real, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
168
+ }
169
+ catch (error) {
170
+ throw fsError(error);
171
+ }
172
+ try {
173
+ const stat = await handle.stat();
174
+ if (stat.isDirectory())
175
+ throw new ProjectFileError("unsupported", "That is a folder. Only files open in the viewer");
176
+ if (!stat.isFile())
177
+ throw new ProjectFileError("unsupported", "Only regular files open in the viewer");
178
+ if (["image", "pdf"].includes(classification(file).kind))
179
+ throw notText();
180
+ // The descriptor is the file the checks passed: a folder above it swapped
181
+ // for a symlink after realpath is refused.
182
+ const named = process.platform === "linux" ? null : await lstat(real);
183
+ const opened = named ? named.ino === stat.ino && named.dev === stat.dev : await realpath(`/proc/self/fd/${handle.fd}`) === real;
184
+ if (!opened)
185
+ throw new ProjectFileError("changed", "The file moved while opening it");
186
+ if (stat.size > FILE_REF_LIMITS.textBytes)
187
+ throw tooLarge();
188
+ const bytes = Buffer.alloc(stat.size + 1);
189
+ let offset = 0;
190
+ while (offset < bytes.length) {
191
+ signal.throwIfAborted();
192
+ const read = await handle.read(bytes, offset, Math.min(64 * 1024, bytes.length - offset), offset);
193
+ if (!read.bytesRead)
194
+ break;
195
+ offset += read.bytesRead;
196
+ }
197
+ if (offset !== stat.size)
198
+ throw new ProjectFileError("changed", "The file changed while reading it");
199
+ const content = bytes.subarray(0, offset);
200
+ const revision = revisionOf(content);
201
+ if (revision === knownRevision)
202
+ return shown(file, revision, undefined, true);
203
+ const text = textOf(content);
204
+ if (text === null)
205
+ throw notText();
206
+ return shown(file, revision, text, false);
207
+ }
208
+ catch (error) {
209
+ throw error instanceof ProjectFileError ? error : fsError(error);
210
+ }
211
+ finally {
212
+ await handle.close();
213
+ }
214
+ }
215
+ /** A filesystem failure as a message the viewer shows; never a raw errno with a path. */
216
+ function fsError(error) {
217
+ if (error instanceof ProjectFileError)
218
+ return error;
219
+ const code = error?.code;
220
+ if (code === "ENOENT" || code === "ENOTDIR")
221
+ return new ProjectFileError("missing", "File not found");
222
+ if (code === "EACCES" || code === "EPERM")
223
+ return new ProjectFileError("denied", "The cloud machine's user cannot read this file");
224
+ if (code === "ELOOP")
225
+ return new ProjectFileError("denied", "This path loops through symlinks");
226
+ if (code === "ENAMETOOLONG")
227
+ return new ProjectFileError("invalid", "This path is too long");
228
+ return new ProjectFileError("changed", "The file could not be read");
229
+ }
230
+ //# sourceMappingURL=file-refs.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"file-refs.js","sourceRoot":"","sources":["../../src/project-files/file-refs.ts"],"names":[],"mappings":"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"}
@@ -1,5 +1,6 @@
1
1
  import { engineFileGrants } from "./engine.js";
2
- import type { FileScope, ProjectFileRequest, ProjectFileResult } from "./types.js";
2
+ import { type FileRefPolicy } from "./file-refs.js";
3
+ import type { FileDocument, FileScope, ProjectFileRequest, ProjectFileResult } from "./types.js";
3
4
  /** Used only by the authenticated home RPC receiver, after selecting its own
4
5
  * registered project. No browser path or control-plane cwd chooses the root.
5
6
  */
@@ -9,5 +10,8 @@ export declare class HomeProjectFiles {
9
10
  constructor(grants?: typeof engineFileGrants);
10
11
  scopes(repo: string, signal?: AbortSignal): Promise<FileScope[]>;
11
12
  dispatch(repo: string, request: ProjectFileRequest, signal?: AbortSignal): Promise<ProjectFileResult>;
13
+ /** A file a chat message in this project names (file-refs.ts). The home's
14
+ * own account only: the Cloud route checks that before it asks. */
15
+ fileRef(repo: string, request: unknown, policy: FileRefPolicy, signal?: AbortSignal): Promise<FileDocument>;
12
16
  close(repo: string): void;
13
17
  }
@@ -1,5 +1,6 @@
1
1
  import { engineFileGrants, sameFileScope } from "./engine.js";
2
- import { ProjectFileError, ProjectFileService } from "./service.js";
2
+ import { readFileRef } from "./file-refs.js";
3
+ import { FILE_LIMITS, ProjectFileError, ProjectFileService } from "./service.js";
3
4
  /** Used only by the authenticated home RPC receiver, after selecting its own
4
5
  * registered project. No browser path or control-plane cwd chooses the root.
5
6
  */
@@ -14,21 +15,31 @@ export class HomeProjectFiles {
14
15
  return this.#bounded(async () => (await this.grants(repo, signal)).map(grant => grant.scope));
15
16
  }
16
17
  async dispatch(repo, request, signal) {
17
- return this.#bounded(async () => {
18
- let service = this.#services.get(repo);
19
- if (!service) {
20
- if (this.#services.size >= 64)
21
- throw new ProjectFileError("busy", "Too many file workspaces are open");
22
- service = new ProjectFileService(async (scope, bounded) => {
23
- const grant = (await this.grants(repo, bounded)).find(item => sameFileScope(scope, item.scope));
24
- if (!grant)
25
- throw new ProjectFileError("denied", "Project file access is no longer current");
26
- return grant;
27
- });
28
- this.#services.set(repo, service);
29
- }
30
- return service.dispatch(request, signal);
31
- });
18
+ return this.#bounded(async () => this.#service(repo).dispatch(request, signal));
19
+ }
20
+ /** A file a chat message in this project names (file-refs.ts). The home's
21
+ * own account only: the Cloud route checks that before it asks. */
22
+ async fileRef(repo, request, policy, signal = AbortSignal.timeout(FILE_LIMITS.timeoutMs)) {
23
+ return this.#bounded(async () => readFileRef(request, {
24
+ grants: (bounded) => this.grants(repo, bounded),
25
+ read: async (scope, path, knownRevision, bounded) => await this.#service(repo).dispatch({ version: 1, operation: "read", scope, path, ...(knownRevision ? { knownRevision } : {}) }, bounded),
26
+ policy,
27
+ }, signal));
28
+ }
29
+ #service(repo) {
30
+ let service = this.#services.get(repo);
31
+ if (!service) {
32
+ if (this.#services.size >= 64)
33
+ throw new ProjectFileError("busy", "Too many file workspaces are open");
34
+ service = new ProjectFileService(async (scope, bounded) => {
35
+ const grant = (await this.grants(repo, bounded)).find(item => sameFileScope(scope, item.scope));
36
+ if (!grant)
37
+ throw new ProjectFileError("denied", "Project file access is no longer current");
38
+ return grant;
39
+ });
40
+ this.#services.set(repo, service);
41
+ }
42
+ return service;
32
43
  }
33
44
  async #bounded(work) {
34
45
  if (this.#active >= 8)
@@ -1 +1 @@
1
- {"version":3,"file":"home.js","sourceRoot":"","sources":["../../src/project-files/home.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGpE;;GAEG;AACH,MAAM,OAAO,gBAAgB;IAGE;IAF7B,SAAS,GAAG,IAAI,GAAG,EAA8B,CAAC;IAClD,OAAO,GAAG,CAAC,CAAC;IACZ,YAA6B,SAAS,gBAAgB;QAAzB,WAAM,GAAN,MAAM,CAAmB;IAAG,CAAC;IAC1D,KAAK,CAAC,MAAM,CAAC,IAAY,EAAE,MAAM,GAAG,WAAW,CAAC,OAAO,CAAC,IAAI,CAAC;QAC3D,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IAChG,CAAC;IACD,KAAK,CAAC,QAAQ,CAAC,IAAY,EAAE,OAA2B,EAAE,MAAoB;QAC5E,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE;YAC9B,IAAI,OAAO,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACvC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,EAAE;oBAAE,MAAM,IAAI,gBAAgB,CAAC,MAAM,EAAE,mCAAmC,CAAC,CAAC;gBACvG,OAAO,GAAG,IAAI,kBAAkB,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;oBACxD,MAAM,KAAK,GAAG,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,aAAa,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;oBAChG,IAAI,CAAC,KAAK;wBAAE,MAAM,IAAI,gBAAgB,CAAC,QAAQ,EAAE,0CAA0C,CAAC,CAAC;oBAC7F,OAAO,KAAK,CAAC;gBACf,CAAC,CAAC,CAAC;gBACH,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACpC,CAAC;YACD,OAAO,OAAO,CAAC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC3C,CAAC,CAAC,CAAC;IACL,CAAC;IACD,KAAK,CAAC,QAAQ,CAAI,IAAsB;QACtC,IAAI,IAAI,CAAC,OAAO,IAAI,CAAC;YAAE,MAAM,IAAI,gBAAgB,CAAC,MAAM,EAAE,iCAAiC,CAAC,CAAC;QAC7F,IAAI,CAAC,OAAO,EAAE,CAAC;QACf,IAAI,CAAC;YAAC,OAAO,MAAM,IAAI,EAAE,CAAC;QAAC,CAAC;gBAAS,CAAC;YAAC,IAAI,CAAC,OAAO,EAAE,CAAC;QAAC,CAAC;IAC1D,CAAC;IACD,KAAK,CAAC,IAAY,IAAU,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;CAC3D"}
1
+ {"version":3,"file":"home.js","sourceRoot":"","sources":["../../src/project-files/home.ts"],"names":[],"mappings":"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"}
@@ -1,4 +1,4 @@
1
- import type { FileAccess, FileScope, ProjectFileRequest, ProjectFileResult } from "./types.js";
1
+ import type { FileAccess, FileDocument, FileScope, ProjectFileRequest, ProjectFileResult } from "./types.js";
2
2
  export declare class ProjectFileError extends Error {
3
3
  readonly code: "denied" | "invalid" | "missing" | "changed" | "large" | "busy" | "unsupported";
4
4
  constructor(code: "denied" | "invalid" | "missing" | "changed" | "large" | "busy" | "unsupported", message: string);
@@ -26,6 +26,10 @@ export declare const FILE_LIMITS: {
26
26
  export declare function validateFileScope(value: unknown): FileScope;
27
27
  export declare function validateFileAccess(value: unknown): FileAccess;
28
28
  export declare function validateFilePath(value: unknown): string;
29
+ export declare function classification(relative: string): Pick<FileDocument, "mime" | "kind">;
30
+ /** UTF-8 text without control characters, or null for binary content. */
31
+ export declare function textOf(content: Buffer): string | null;
32
+ export declare const revisionOf: (bytes: Buffer) => string;
29
33
  /** No listeners, persistent watchers, synchronous filesystem IO or scheduling. */
30
34
  export declare class ProjectFileService {
31
35
  #private;
@@ -80,7 +80,7 @@ function sameFile(a, b) { return a.dev === b.dev && a.ino === b.ino; }
80
80
  function sameVersion(a, b) {
81
81
  return sameFile(a, b) && a.size === b.size && a.mtimeMs === b.mtimeMs && a.ctimeMs === b.ctimeMs;
82
82
  }
83
- function classification(relative) {
83
+ export function classification(relative) {
84
84
  const ext = path.extname(relative).toLowerCase();
85
85
  const images = { ".png": "image/png", ".jpg": "image/jpeg", ".jpeg": "image/jpeg", ".gif": "image/gif", ".webp": "image/webp", ".avif": "image/avif" };
86
86
  if (images[ext])
@@ -109,7 +109,7 @@ function validMedia(bytes, mime) {
109
109
  return false;
110
110
  }
111
111
  /** UTF-8 text without control characters, or null for binary content. */
112
- function textOf(content) {
112
+ export function textOf(content) {
113
113
  if (content.includes(0))
114
114
  return null;
115
115
  try {
@@ -120,7 +120,7 @@ function textOf(content) {
120
120
  return null;
121
121
  }
122
122
  }
123
- const revisionOf = (bytes) => createHash("sha256").update(bytes).digest("hex");
123
+ export const revisionOf = (bytes) => createHash("sha256").update(bytes).digest("hex");
124
124
  async function placeOf(grant) {
125
125
  if (!path.isAbsolute(grant.root) || path.normalize(grant.root) !== grant.root)
126
126
  throw new ProjectFileError("denied", "Project file access is no longer current");