@powerhousedao/reactor-mcp 6.2.3-dev.79 → 6.2.3-dev.80

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.
@@ -0,0 +1,131 @@
1
+ import { ReactorToolClient, ReactorToolWriteClient, ToolDefinition } from "./tools/index.mjs";
2
+ import { ConsistencyToken, IReactorClient, ISyncManager, NewDocumentOptions, OperationFilter, PagedResults, PagingOptions, SearchFilter, ViewFilter } from "@powerhousedao/reactor";
3
+ import { z } from "zod";
4
+ import { Action, AuthSubject, PHDocument } from "@powerhousedao/shared/document-model";
5
+ //#region src/host-access.d.ts
6
+ /** The host's access decisions for one caller, as its GraphQL API makes them; ids are canonical. */
7
+ interface McpAccess {
8
+ /** Policy-wide access (OPEN or a supreme admin): per-document checks are skipped. */
9
+ readonly unrestricted: boolean;
10
+ /** Whether the caller is authenticated; a refused create says which. */
11
+ readonly authenticated: boolean;
12
+ canRead(documentId: string): Promise<boolean>;
13
+ canWrite(documentId: string): Promise<boolean>;
14
+ canMutate(documentId: string, operationType: string): Promise<boolean>;
15
+ canCreate(): boolean | Promise<boolean>;
16
+ /** Called after the caller created a document, so the host records its owner. */
17
+ created?(documentId: string): Promise<void>;
18
+ }
19
+ /** Resolves identifiers the way the host's GraphQL checks do. */
20
+ type HostAccessIdentity = Pick<IReactorClient, "resolveIdOrSlug"> & {
21
+ readonly write: Pick<IReactorClient["write"], "describe">;
22
+ };
23
+ type DeniedAction = {
24
+ index: number;
25
+ type: string;
26
+ reason: string;
27
+ };
28
+ /** A batch the host's ACL refused, by action index; nothing in it was written. */
29
+ declare class HostAccessDeniedError extends Error {
30
+ readonly denied: DeniedAction[];
31
+ constructor(denied: DeniedAction[]);
32
+ }
33
+ /** The checks GraphQL's resolvers apply, for one caller. */
34
+ declare class HostAccessGate {
35
+ private readonly access;
36
+ private readonly ids;
37
+ constructor(access: McpAccess, ids: HostAccessIdentity);
38
+ get unrestricted(): boolean;
39
+ private canonical;
40
+ /** GraphQL's assertCanRead: the id to fetch, or FORBIDDEN. */
41
+ read(identifier: string, signal?: AbortSignal): Promise<string>;
42
+ /** GraphQL's assertCanWrite: the id to write, or FORBIDDEN. */
43
+ write(identifier: string, signal?: AbortSignal): Promise<string>;
44
+ /** GraphQL's assertCanExecuteOperations: canMutate per action type. */
45
+ mutate(identifier: string, actions: readonly Pick<Action, "type">[], signal?: AbortSignal): Promise<string>;
46
+ /** GraphQL's create rule: write on the parent, else canCreate. */
47
+ create(parent?: string, signal?: AbortSignal): Promise<void>;
48
+ created(documentId: string): Promise<void>;
49
+ readable<T>(items: readonly T[], idOf: (item: T) => string): Promise<T[]>;
50
+ /** The readable part of a page; an emptied page moves on, so a listing does not stop early. */
51
+ readablePage<T>(page: PagedResults<T>, idOf: (item: T) => string): Promise<PagedResults<T>>;
52
+ }
53
+ type EvaluateActions = IReactorClient["write"]["evaluateActions"];
54
+ /** The tool client behind the host's ACL as GraphQL applies it. */
55
+ declare class HostAccessClient implements ReactorToolClient {
56
+ private readonly inner;
57
+ private readonly gate;
58
+ readonly write: ReactorToolWriteClient & {
59
+ evaluateActions: EvaluateActions;
60
+ /** Checked before deleteDocument changes anything. */
61
+ authorizeDelete(id: string, signal?: AbortSignal): Promise<void>;
62
+ };
63
+ constructor(inner: ReactorToolClient & {
64
+ readonly write: {
65
+ evaluateActions: EvaluateActions;
66
+ };
67
+ }, gate: HostAccessGate);
68
+ private authorizeDelete;
69
+ get<T extends PHDocument>(id: string, view?: ViewFilter, signal?: AbortSignal, consistencyToken?: ConsistencyToken): Promise<T>;
70
+ resolveIdOrSlug(id: string, view?: ViewFilter, signal?: AbortSignal, consistencyToken?: ConsistencyToken): Promise<string>;
71
+ find(search: SearchFilter, view?: ViewFilter, paging?: PagingOptions, signal?: AbortSignal, consistencyToken?: ConsistencyToken): Promise<PagedResults<PHDocument>>;
72
+ getOperations(id: string, view?: ViewFilter, filter?: OperationFilter, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<import("@powerhousedao/shared/document-model").Operation>>;
73
+ getOutgoingRelationships(id: string, type: string, view?: ViewFilter, paging?: PagingOptions, signal?: AbortSignal, consistencyToken?: ConsistencyToken): Promise<PagedResults<PHDocument>>;
74
+ getIncomingRelationships(id: string, type: string, view?: ViewFilter, paging?: PagingOptions, signal?: AbortSignal, consistencyToken?: ConsistencyToken): Promise<PagedResults<PHDocument>>;
75
+ getOutgoingRelationshipEdges(id: string, type?: string, view?: ViewFilter, paging?: PagingOptions, signal?: AbortSignal, consistencyToken?: ConsistencyToken): Promise<PagedResults<import("@powerhousedao/reactor").DocumentRelationship>>;
76
+ getIncomingRelationshipEdges(id: string, type?: string, view?: ViewFilter, paging?: PagingOptions, signal?: AbortSignal, consistencyToken?: ConsistencyToken): Promise<PagedResults<import("@powerhousedao/reactor").DocumentRelationship>>;
77
+ getDocumentModelModules(namespace?: string, paging?: PagingOptions, signal?: AbortSignal): Promise<PagedResults<import("@powerhousedao/shared/document-model").DocumentModelModule>>;
78
+ getDocumentModelModule(documentType: string): Promise<import("@powerhousedao/shared/document-model").DocumentModelModule<any>>;
79
+ getDocumentModelModuleForDocument(document: PHDocument): Promise<import("@powerhousedao/shared/document-model").DocumentModelModule<any>>;
80
+ newDocument<T extends PHDocument = PHDocument>(documentType: string, options?: NewDocumentOptions, signal?: AbortSignal): Promise<T>;
81
+ }
82
+ //#endregion
83
+ //#region src/admin-tools.d.ts
84
+ /** URLs `addRemoteDrive` may fetch: `"*"`, origins or URL prefixes, patterns, or a predicate. */
85
+ type RemoteDriveAllowlist = "*" | readonly (string | RegExp)[] | ((url: URL) => boolean);
86
+ type ReactorAdminToolsOptions = {
87
+ syncManager?: ISyncManager;
88
+ /** Omitted, `addRemoteDrive` is not mounted. */
89
+ remoteDriveUrls?: RemoteDriveAllowlist;
90
+ /** Who `deleteDrive` reads the drive as; omitted, the client's signer. */
91
+ subject?: AuthSubject;
92
+ /** The host's ACL for the caller; omitted, none. */
93
+ gate?: HostAccessGate;
94
+ };
95
+ declare function isRemoteDriveUrlAllowed(url: URL, allow: RemoteDriveAllowlist | undefined): boolean;
96
+ /** Drive administration over the full client. `addRemoteDrive` is mounted
97
+ * only when the host allows remote drive URLs and has a sync manager. */
98
+ declare function reactorAdminTools(options?: ReactorAdminToolsOptions): (ToolDefinition<z.ZodObject<{
99
+ name: z.ZodOptional<z.ZodString>;
100
+ icon: z.ZodOptional<z.ZodNullable<z.ZodString>>;
101
+ preferredEditor: z.ZodOptional<z.ZodString>;
102
+ driveInput: z.ZodOptional<z.ZodObject<{
103
+ name: z.ZodOptional<z.ZodString>;
104
+ icon: z.ZodOptional<z.ZodNullable<z.ZodString>>;
105
+ global: z.ZodOptional<z.ZodObject<{
106
+ name: z.ZodString;
107
+ icon: z.ZodOptional<z.ZodNullable<z.ZodString>>;
108
+ }, z.core.$strip>>;
109
+ preferredEditor: z.ZodOptional<z.ZodString>;
110
+ local: z.ZodOptional<z.ZodObject<{
111
+ availableOffline: z.ZodOptional<z.ZodBoolean>;
112
+ sharingType: z.ZodOptional<z.ZodNullable<z.ZodString>>;
113
+ }, z.core.$strip>>;
114
+ }, z.core.$strip>>;
115
+ }, z.core.$strip>, z.ZodObject<{
116
+ driveId: z.ZodString;
117
+ }, z.core.$strip>, IReactorClient, "addDrive"> | ToolDefinition<z.ZodObject<{
118
+ documentId: z.ZodOptional<z.ZodString>;
119
+ driveId: z.ZodOptional<z.ZodString>;
120
+ id: z.ZodOptional<z.ZodString>;
121
+ }, z.core.$strip>, z.ZodObject<{
122
+ driveId: z.ZodString;
123
+ }, z.core.$strip>, IReactorClient, "deleteDrive"> | ToolDefinition<z.ZodObject<{
124
+ url: z.ZodString;
125
+ }, z.core.$strip>, z.ZodObject<{
126
+ driveId: z.ZodString;
127
+ }, z.core.$strip>, IReactorClient, "addRemoteDrive">)[];
128
+ //#endregion
129
+ export { HostAccessClient as a, HostAccessIdentity as c, reactorAdminTools as i, McpAccess as l, RemoteDriveAllowlist as n, HostAccessDeniedError as o, isRemoteDriveUrlAllowed as r, HostAccessGate as s, ReactorAdminToolsOptions as t };
130
+ export {};
131
+ //# sourceMappingURL=admin-tools-B-ZmrfuR.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"admin-tools-B-ZmrfuR.d.mts","names":[],"sources":["../src/host-access.ts","../src/admin-tools.ts"],"mappings":";;;;;;UAmBiB;;WAEN;;WAEA;EACT,QAAQ,qBAAqB;EAC7B,SAAS,qBAAqB;EAC9B,UAAU,oBAAoB,wBAAwB;EACtD,uBAAuB;;EAEvB,SAAS,qBAAqB;;;KAIpB,qBAAqB,KAAK;WAC3B,OAAO,KAAK;;KAGlB;EAAiB;EAAe;EAAc;;;cAGtC,8BAA8B;WAChC,QAAQ;EAEjB,YAAY,QAAQ;;;cAaT;mBAEQ;mBACA;EAFnB,YACmB,QAAQ,WACR,KAAK;MAGpB;UAKU;;EAiBR,KAAK,oBAAoB,SAAS,cAAc;;EAShD,MAAM,oBAAoB,SAAS,cAAc;;EASjD,OACJ,oBACA,kBAAkB,KAAK,mBACvB,SAAS,cACR;;EAwBG,OAAO,iBAAiB,SAAS,cAAc;EAc/C,QAAQ,qBAAqB;EAI7B,SAAS,GAAG,gBAAgB,KAAK,OAAO,MAAM,eAAY,QAAA;;EAiB1D,aAAa,GACjB,MAAM,aAAa,IACnB,OAAO,MAAM,eACZ,QAAQ,aAAa;;KAiBrB,kBAAkB;;cAGV,4BAA4B;mBAQpB;mBAGA;WAVV,OAAO;IACd,iBAAiB;;IAEjB,gBAAgB,YAAY,SAAS,cAAc;;EAGrD,YACmB,OAAO;aACb;MAAS,iBAAiB;;KAEpB,MAAM;UAwDX;EA2BR,IAAI,UAAU,YAClB,YACA,OAAO,YACP,SAAS,aACT,mBAAmB,mBAAgB,QAAA;EAU/B,gBACJ,YACA,OAAO,YACP,SAAS,aACT,mBAAmB,mBAAgB;EAU/B,KACJ,QAAQ,cACR,OAAO,YACP,SAAS,eACT,SAAS,aACT,mBAAmB,mBAAgB,QAAA,aAAA;EAQ/B,cACJ,YACA,OAAO,YACP,SAAS,iBACT,SAAS,eACT,SAAS,cAAW,QAAA,4DAAA;EAWhB,yBACJ,YACA,cACA,OAAO,YACP,SAAS,eACT,SAAS,aACT,mBAAmB,mBAAgB,QAAA,aAAA;EAe/B,yBACJ,YACA,cACA,OAAO,YACP,SAAS,eACT,SAAS,aACT,mBAAmB,mBAAgB,QAAA,aAAA;EAe/B,6BACJ,YACA,eACA,OAAO,YACP,SAAS,eACT,SAAS,aACT,mBAAmB,mBAAgB,QAAA,8CAAA;EAe/B,6BACJ,YACA,eACA,OAAO,YACP,SAAS,eACT,SAAS,aACT,mBAAmB,mBAAgB,QAAA,8CAAA;EAerC,wBACE,oBACA,SAAS,eACT,SAAS,cAAW,QAAA,4DAAA;EAKtB,uBAAuB,uBAAoB,uDAAA;EAI3C,kCAAkC,UAAU,aAAU,uDAAA;EAItD,YAAY,UAAU,aAAa,YACjC,sBACA,UAAU,oBACV,SAAS,cAAW,QAAA;;;;;KChZZ,gDAEW,cACjB,KAAK;KAEC;EACV,cAAc;;EAEd,kBAAkB;;EAElB,UAAU;;EAEV,OAAO;;iBAWO,wBACd,KAAK,KACL,OAAO;;;iBAwUO,kBAAkB,UAAS,4BAA6B,eAAA,EAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAUvE,EAAA,KAAA,SAAA"}
@@ -0,0 +1,3 @@
1
+ import { i as reactorAdminTools, n as RemoteDriveAllowlist, r as isRemoteDriveUrlAllowed, t as ReactorAdminToolsOptions } from "./admin-tools-B-ZmrfuR.mjs";
2
+ export { ReactorAdminToolsOptions, RemoteDriveAllowlist, isRemoteDriveUrlAllowed, reactorAdminTools };
3
+ export {};
@@ -0,0 +1,192 @@
1
+ import { DRIVE_DOCUMENT_TYPE, ReactorToolError, aliasParam, executeBuiltActions, getDocument, targetId, targetParam, toReactorToolError } from "./tools/index.mjs";
2
+ import { DEFAULT_DRIVE_CONTAINER_TYPES, DriveCollectionId } from "@powerhousedao/reactor";
3
+ import { setAvailableOffline, setDriveIcon, setDriveName, setSharingType } from "@powerhousedao/shared/document-drive";
4
+ import { z } from "zod";
5
+ //#region src/admin-tools.ts
6
+ function defineTool(definition) {
7
+ return definition;
8
+ }
9
+ function parseUrl(value) {
10
+ try {
11
+ return new URL(value);
12
+ } catch {
13
+ throw new ReactorToolError("INVALID_ACTION", `Invalid URL: ${value}`);
14
+ }
15
+ }
16
+ function isRemoteDriveUrlAllowed(url, allow) {
17
+ if (url.protocol !== "http:" && url.protocol !== "https:") return false;
18
+ if (!allow) return false;
19
+ if (allow === "*") return true;
20
+ if (typeof allow === "function") return allow(url);
21
+ return allow.some((entry) => {
22
+ if (entry instanceof RegExp) return new RegExp(entry.source, entry.flags.replace(/[gy]/g, "")).test(url.href);
23
+ const allowed = parseUrl(entry);
24
+ if (allowed.origin !== url.origin) return false;
25
+ const prefix = allowed.pathname.replace(/\/+$/, "");
26
+ return prefix === "" || url.pathname === prefix || url.pathname.startsWith(`${prefix}/`);
27
+ });
28
+ }
29
+ const write = {
30
+ readOnlyHint: false,
31
+ destructiveHint: false,
32
+ openWorldHint: false
33
+ };
34
+ /** The value `addDrive` got for a field in any of its shapes; they must agree. */
35
+ function driveField(field, values) {
36
+ const given = new Set(values.filter((value) => value != null && value !== ""));
37
+ if (given.size > 1) throw new ReactorToolError("INVALID_ACTION", `addDrive got different values for \`${field}\`; pass it once, at the top level`);
38
+ const [value] = given;
39
+ return value;
40
+ }
41
+ const driveIcon = z.string().nullable().optional().describe("Optional icon");
42
+ const drivePreferredEditor = z.string().optional().describe("App/editor module id recorded as the drive's preferred editor");
43
+ const addDriveTool = (gate) => defineTool({
44
+ name: "addDrive",
45
+ title: "Create a drive",
46
+ description: "Create a new drive. Pass `name` and, optionally, `icon` and `preferredEditor` at the top level. The older `driveInput` object is still accepted.",
47
+ inputSchema: z.object({
48
+ name: z.string().optional().describe("Name of the drive. Required."),
49
+ icon: driveIcon,
50
+ preferredEditor: drivePreferredEditor,
51
+ driveInput: z.object({
52
+ name: z.string().optional(),
53
+ icon: driveIcon,
54
+ global: z.object({
55
+ name: z.string().describe("Name of the drive"),
56
+ icon: driveIcon
57
+ }).optional(),
58
+ preferredEditor: drivePreferredEditor,
59
+ local: z.object({
60
+ availableOffline: z.boolean().optional(),
61
+ sharingType: z.string().nullable().optional()
62
+ }).optional()
63
+ }).optional().describe("Older form of the drive configuration; prefer the top-level fields")
64
+ }),
65
+ outputSchema: z.object({ driveId: z.string() }),
66
+ annotations: write,
67
+ async execute(args, { client, signal }) {
68
+ const { driveInput } = args;
69
+ const name = driveField("name", [
70
+ args.name,
71
+ driveInput?.name,
72
+ driveInput?.global?.name
73
+ ]);
74
+ if (!name) throw new ReactorToolError("INVALID_ACTION", "addDrive needs the drive's `name`");
75
+ const icon = driveField("icon", [
76
+ args.icon,
77
+ driveInput?.icon,
78
+ driveInput?.global?.icon
79
+ ]);
80
+ const preferredEditor = driveField("preferredEditor", [args.preferredEditor, driveInput?.preferredEditor]);
81
+ await gate?.create(void 0, signal);
82
+ try {
83
+ const { documentId: driveId } = await (await client.write.createEmpty(DRIVE_DOCUMENT_TYPE, {}, signal)).readable;
84
+ await gate?.created(driveId);
85
+ await gate?.write(driveId, signal);
86
+ if (preferredEditor) await (await client.write.setPreferredEditor(driveId, preferredEditor, void 0, signal)).readable;
87
+ await (await client.write.rename(driveId, name, void 0, signal)).readable;
88
+ const actions = [setDriveName({ name })];
89
+ if (icon) actions.push(setDriveIcon({ icon }));
90
+ if (driveInput?.local?.sharingType) actions.push(setSharingType({ type: driveInput.local.sharingType }));
91
+ if (driveInput?.local?.availableOffline !== void 0) actions.push(setAvailableOffline({ availableOffline: driveInput.local.availableOffline }));
92
+ await gate?.mutate(driveId, actions, signal);
93
+ const current = await getDocument(client, driveId, signal);
94
+ await executeBuiltActions(client, current, actions, { signal });
95
+ return { driveId };
96
+ } catch (error) {
97
+ throw toReactorToolError(error);
98
+ }
99
+ }
100
+ });
101
+ function deleteDriveTool(subject, gate) {
102
+ return defineTool({
103
+ name: "deleteDrive",
104
+ title: "Delete a drive",
105
+ description: "Delete a drive, passed as `documentId`.",
106
+ inputSchema: z.object({
107
+ documentId: targetParam("drive to delete"),
108
+ driveId: aliasParam,
109
+ id: aliasParam
110
+ }),
111
+ outputSchema: z.object({ driveId: z.string() }),
112
+ annotations: {
113
+ readOnlyHint: false,
114
+ destructiveHint: true,
115
+ openWorldHint: false
116
+ },
117
+ async execute(args, { client, signal }) {
118
+ const target = targetId("deleteDrive", args, ["driveId", "id"]);
119
+ const driveId = gate ? await gate.write(target, signal) : target;
120
+ let drive;
121
+ try {
122
+ drive = await client.get(driveId, subject ? { subject } : void 0, signal);
123
+ } catch (error) {
124
+ throw toReactorToolError(error, "NOT_FOUND");
125
+ }
126
+ if (!DEFAULT_DRIVE_CONTAINER_TYPES.has(drive.header.documentType)) throw new ReactorToolError("INVALID_ACTION", `${driveId} is a ${drive.header.documentType}, not a drive; use deleteDocument`);
127
+ if (!drive.state.global) throw new ReactorToolError("FORBIDDEN", `You cannot read drive ${drive.header.id}, so you cannot delete it`);
128
+ try {
129
+ await (await client.write.deleteDocument(drive.header.id, void 0, signal)).readable;
130
+ } catch (error) {
131
+ throw toReactorToolError(error);
132
+ }
133
+ return { driveId: drive.header.id };
134
+ }
135
+ });
136
+ }
137
+ function addRemoteDriveTool(options) {
138
+ return defineTool({
139
+ name: "addRemoteDrive",
140
+ title: "Connect a remote drive",
141
+ description: "Connect to a remote drive by its URL and sync it. Only URLs this server allows are fetched.",
142
+ inputSchema: z.object({ url: z.string().describe("URL of the remote drive") }),
143
+ outputSchema: z.object({ driveId: z.string() }),
144
+ annotations: {
145
+ readOnlyHint: false,
146
+ destructiveHint: false,
147
+ openWorldHint: true
148
+ },
149
+ async execute(args, { signal }) {
150
+ const { syncManager, remoteDriveUrls, gate } = options;
151
+ if (gate && !gate.unrestricted) throw new ReactorToolError("FORBIDDEN", "Forbidden: only an administrator may connect remote drives");
152
+ if (!syncManager) throw new ReactorToolError("FORBIDDEN", "Remote drives are not available: this server has no sync manager");
153
+ const url = parseUrl(args.url);
154
+ if (!isRemoteDriveUrlAllowed(url, remoteDriveUrls)) throw new ReactorToolError("FORBIDDEN", `This server does not allow fetching ${url.origin}`);
155
+ const response = await fetch(url, {
156
+ signal,
157
+ redirect: "manual"
158
+ });
159
+ if (response.type === "opaqueredirect" || response.status >= 300 && response.status < 400) throw new ReactorToolError("FORBIDDEN", `${url.href} redirected; give the drive's final URL`);
160
+ if (!response.ok) throw new ReactorToolError(response.status === 404 ? "NOT_FOUND" : "CONFLICT", `Failed to resolve drive info from ${url.href}: HTTP ${response.status}`);
161
+ const info = await response.json();
162
+ if (typeof info.id !== "string" || typeof info.graphqlEndpoint !== "string") throw new ReactorToolError("NOT_FOUND", `${url.href} did not describe a drive`);
163
+ let endpoint;
164
+ try {
165
+ endpoint = new URL(info.graphqlEndpoint, url);
166
+ } catch {
167
+ throw new ReactorToolError("NOT_FOUND", `${url.href} named an invalid graphqlEndpoint`);
168
+ }
169
+ if (!isRemoteDriveUrlAllowed(endpoint, remoteDriveUrls)) throw new ReactorToolError("FORBIDDEN", `This server does not allow syncing with ${endpoint.origin}`);
170
+ const collectionId = DriveCollectionId.forDrive(info.id);
171
+ if (!syncManager.list().find((remote) => remote.meta.collectionId.equals(collectionId))) await syncManager.add(`mcp-remote-${crypto.randomUUID()}`, collectionId, {
172
+ type: "gql",
173
+ parameters: { url: endpoint.href }
174
+ });
175
+ return { driveId: info.id };
176
+ }
177
+ });
178
+ }
179
+ /** Drive administration over the full client. `addRemoteDrive` is mounted
180
+ * only when the host allows remote drive URLs and has a sync manager. */
181
+ function reactorAdminTools(options = {}) {
182
+ const remote = options.remoteDriveUrls && options.syncManager ? [addRemoteDriveTool(options)] : [];
183
+ return [
184
+ addDriveTool(options.gate),
185
+ deleteDriveTool(options.subject, options.gate),
186
+ ...remote
187
+ ];
188
+ }
189
+ //#endregion
190
+ export { isRemoteDriveUrlAllowed, reactorAdminTools };
191
+
192
+ //# sourceMappingURL=admin-tools.mjs.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"admin-tools.mjs","names":[],"sources":["../src/admin-tools.ts"],"sourcesContent":["import type { IReactorClient, ISyncManager } from \"@powerhousedao/reactor\";\nimport {\n DEFAULT_DRIVE_CONTAINER_TYPES,\n DriveCollectionId,\n} from \"@powerhousedao/reactor\";\nimport {\n setAvailableOffline,\n setDriveIcon,\n setDriveName,\n setSharingType,\n} from \"@powerhousedao/shared/document-drive\";\nimport type {\n Action,\n AuthSubject,\n PHDocument,\n} from \"@powerhousedao/shared/document-model\";\nimport { z } from \"zod\";\nimport {\n aliasParam,\n DRIVE_DOCUMENT_TYPE,\n executeBuiltActions,\n getDocument,\n ReactorToolError,\n targetId,\n targetParam,\n toReactorToolError,\n type ToolDefinition,\n} from \"./tools/index.js\";\nimport type { HostAccessGate } from \"./host-access.js\";\n\n// Admin tools need the full client: rename, preferred editor, sync.\nfunction defineTool<\n I extends z.ZodObject,\n O extends z.ZodObject,\n N extends string,\n>(\n definition: ToolDefinition<I, O, IReactorClient, N>,\n): ToolDefinition<I, O, IReactorClient, N> {\n return definition;\n}\n\n/** URLs `addRemoteDrive` may fetch: `\"*\"`, origins or URL prefixes, patterns, or a predicate. */\nexport type RemoteDriveAllowlist =\n | \"*\"\n | readonly (string | RegExp)[]\n | ((url: URL) => boolean);\n\nexport type ReactorAdminToolsOptions = {\n syncManager?: ISyncManager;\n /** Omitted, `addRemoteDrive` is not mounted. */\n remoteDriveUrls?: RemoteDriveAllowlist;\n /** Who `deleteDrive` reads the drive as; omitted, the client's signer. */\n subject?: AuthSubject;\n /** The host's ACL for the caller; omitted, none. */\n gate?: HostAccessGate;\n};\n\nfunction parseUrl(value: string): URL {\n try {\n return new URL(value);\n } catch {\n throw new ReactorToolError(\"INVALID_ACTION\", `Invalid URL: ${value}`);\n }\n}\n\nexport function isRemoteDriveUrlAllowed(\n url: URL,\n allow: RemoteDriveAllowlist | undefined,\n): boolean {\n if (url.protocol !== \"http:\" && url.protocol !== \"https:\") return false;\n if (!allow) return false;\n if (allow === \"*\") return true;\n if (typeof allow === \"function\") return allow(url);\n return allow.some((entry) => {\n // A stateless copy: `test` on a /g or /y pattern advances `lastIndex`.\n if (entry instanceof RegExp) {\n return new RegExp(entry.source, entry.flags.replace(/[gy]/g, \"\")).test(\n url.href,\n );\n }\n const allowed = parseUrl(entry);\n if (allowed.origin !== url.origin) return false;\n // A bare origin allows every path on it; a path allows itself and below.\n const prefix = allowed.pathname.replace(/\\/+$/, \"\");\n return (\n prefix === \"\" ||\n url.pathname === prefix ||\n url.pathname.startsWith(`${prefix}/`)\n );\n });\n}\n\nconst write = {\n readOnlyHint: false,\n destructiveHint: false,\n openWorldHint: false,\n};\n\n/** The value `addDrive` got for a field in any of its shapes; they must agree. */\nfunction driveField<T>(\n field: string,\n values: (T | null | undefined)[],\n): T | undefined {\n const given = new Set(\n values.filter((value): value is T => value != null && value !== \"\"),\n );\n if (given.size > 1) {\n throw new ReactorToolError(\n \"INVALID_ACTION\",\n `addDrive got different values for \\`${field}\\`; pass it once, at the top level`,\n );\n }\n const [value] = given;\n return value;\n}\n\nconst driveIcon = z.string().nullable().optional().describe(\"Optional icon\");\nconst drivePreferredEditor = z\n .string()\n .optional()\n .describe(\"App/editor module id recorded as the drive's preferred editor\");\n\nconst addDriveTool = (gate: HostAccessGate | undefined) =>\n defineTool({\n name: \"addDrive\",\n title: \"Create a drive\",\n description:\n \"Create a new drive. Pass `name` and, optionally, `icon` and `preferredEditor` at the top level. The older `driveInput` object is still accepted.\",\n inputSchema: z.object({\n name: z.string().optional().describe(\"Name of the drive. Required.\"),\n icon: driveIcon,\n preferredEditor: drivePreferredEditor,\n driveInput: z\n .object({\n name: z.string().optional(),\n icon: driveIcon,\n global: z\n .object({\n name: z.string().describe(\"Name of the drive\"),\n icon: driveIcon,\n })\n .optional(),\n preferredEditor: drivePreferredEditor,\n local: z\n .object({\n availableOffline: z.boolean().optional(),\n sharingType: z.string().nullable().optional(),\n })\n .optional(),\n })\n .optional()\n .describe(\n \"Older form of the drive configuration; prefer the top-level fields\",\n ),\n }),\n outputSchema: z.object({ driveId: z.string() }),\n annotations: write,\n async execute(args, { client, signal }) {\n const { driveInput } = args;\n const name = driveField(\"name\", [\n args.name,\n driveInput?.name,\n driveInput?.global?.name,\n ]);\n if (!name) {\n throw new ReactorToolError(\n \"INVALID_ACTION\",\n \"addDrive needs the drive's `name`\",\n );\n }\n const icon = driveField(\"icon\", [\n args.icon,\n driveInput?.icon,\n driveInput?.global?.icon,\n ]);\n const preferredEditor = driveField(\"preferredEditor\", [\n args.preferredEditor,\n driveInput?.preferredEditor,\n ]);\n // GraphQL's createEmptyDocument, then rename, setPreferredEditor and mutate.\n await gate?.create(undefined, signal);\n try {\n const created = await client.write.createEmpty(\n DRIVE_DOCUMENT_TYPE,\n {},\n signal,\n );\n const { documentId: driveId } = await created.readable;\n await gate?.created(driveId);\n await gate?.write(driveId, signal);\n // Before the rename, so reactors without the document-view name fix keep it.\n if (preferredEditor) {\n const editor = await client.write.setPreferredEditor(\n driveId,\n preferredEditor,\n undefined,\n signal,\n );\n await editor.readable;\n }\n const renamed = await client.write.rename(\n driveId,\n name,\n undefined,\n signal,\n );\n await renamed.readable;\n const actions: Action[] = [setDriveName({ name })];\n if (icon) {\n actions.push(setDriveIcon({ icon }));\n }\n if (driveInput?.local?.sharingType) {\n actions.push(setSharingType({ type: driveInput.local.sharingType }));\n }\n if (driveInput?.local?.availableOffline !== undefined) {\n actions.push(\n setAvailableOffline({\n availableOffline: driveInput.local.availableOffline,\n }),\n );\n }\n await gate?.mutate(driveId, actions, signal);\n const current = await getDocument(client, driveId, signal);\n await executeBuiltActions(client, current, actions, { signal });\n return { driveId };\n } catch (error) {\n throw toReactorToolError(error);\n }\n },\n });\n\nfunction deleteDriveTool(\n subject: AuthSubject | undefined,\n gate: HostAccessGate | undefined,\n) {\n return defineTool({\n name: \"deleteDrive\",\n title: \"Delete a drive\",\n description: \"Delete a drive, passed as `documentId`.\",\n inputSchema: z.object({\n documentId: targetParam(\"drive to delete\"),\n driveId: aliasParam,\n id: aliasParam,\n }),\n outputSchema: z.object({ driveId: z.string() }),\n annotations: {\n readOnlyHint: false,\n destructiveHint: true,\n openWorldHint: false,\n },\n async execute(args, { client, signal }) {\n const target = targetId(\"deleteDrive\", args, [\"driveId\", \"id\"]);\n // GraphQL's deleteDocument check.\n const driveId = gate ? await gate.write(target, signal) : target;\n // Read as the caller, so the delete is no way around read gating.\n let drive: PHDocument;\n try {\n drive = await client.get(\n driveId,\n subject ? { subject } : undefined,\n signal,\n );\n } catch (error) {\n throw toReactorToolError(error, \"NOT_FOUND\");\n }\n if (!DEFAULT_DRIVE_CONTAINER_TYPES.has(drive.header.documentType)) {\n throw new ReactorToolError(\n \"INVALID_ACTION\",\n `${driveId} is a ${drive.header.documentType}, not a drive; use deleteDocument`,\n );\n }\n if (!(drive.state as { global?: unknown }).global) {\n throw new ReactorToolError(\n \"FORBIDDEN\",\n `You cannot read drive ${drive.header.id}, so you cannot delete it`,\n );\n }\n try {\n const deleted = await client.write.deleteDocument(\n drive.header.id,\n undefined,\n signal,\n );\n await deleted.readable;\n } catch (error) {\n throw toReactorToolError(error);\n }\n return { driveId: drive.header.id };\n },\n });\n}\n\nfunction addRemoteDriveTool(options: ReactorAdminToolsOptions) {\n return defineTool({\n name: \"addRemoteDrive\",\n title: \"Connect a remote drive\",\n description:\n \"Connect to a remote drive by its URL and sync it. Only URLs this server allows are fetched.\",\n inputSchema: z.object({\n url: z.string().describe(\"URL of the remote drive\"),\n }),\n outputSchema: z.object({ driveId: z.string() }),\n annotations: {\n readOnlyHint: false,\n destructiveHint: false,\n openWorldHint: true,\n },\n async execute(args, { signal }) {\n const { syncManager, remoteDriveUrls, gate } = options;\n // Sync configuration is host-wide, as GraphQL's sync admin is.\n if (gate && !gate.unrestricted) {\n throw new ReactorToolError(\n \"FORBIDDEN\",\n \"Forbidden: only an administrator may connect remote drives\",\n );\n }\n if (!syncManager) {\n throw new ReactorToolError(\n \"FORBIDDEN\",\n \"Remote drives are not available: this server has no sync manager\",\n );\n }\n const url = parseUrl(args.url);\n if (!isRemoteDriveUrlAllowed(url, remoteDriveUrls)) {\n throw new ReactorToolError(\n \"FORBIDDEN\",\n `This server does not allow fetching ${url.origin}`,\n );\n }\n // Redirects would bypass the allowlist.\n const response = await fetch(url, { signal, redirect: \"manual\" });\n if (\n response.type === \"opaqueredirect\" ||\n (response.status >= 300 && response.status < 400)\n ) {\n throw new ReactorToolError(\n \"FORBIDDEN\",\n `${url.href} redirected; give the drive's final URL`,\n );\n }\n if (!response.ok) {\n throw new ReactorToolError(\n response.status === 404 ? \"NOT_FOUND\" : \"CONFLICT\",\n `Failed to resolve drive info from ${url.href}: HTTP ${response.status}`,\n );\n }\n const info = (await response.json()) as {\n id?: unknown;\n graphqlEndpoint?: unknown;\n };\n if (\n typeof info.id !== \"string\" ||\n typeof info.graphqlEndpoint !== \"string\"\n ) {\n throw new ReactorToolError(\n \"NOT_FOUND\",\n `${url.href} did not describe a drive`,\n );\n }\n let endpoint: URL;\n try {\n endpoint = new URL(info.graphqlEndpoint, url);\n } catch {\n throw new ReactorToolError(\n \"NOT_FOUND\",\n `${url.href} named an invalid graphqlEndpoint`,\n );\n }\n if (!isRemoteDriveUrlAllowed(endpoint, remoteDriveUrls)) {\n throw new ReactorToolError(\n \"FORBIDDEN\",\n `This server does not allow syncing with ${endpoint.origin}`,\n );\n }\n const collectionId = DriveCollectionId.forDrive(info.id);\n const existing = syncManager\n .list()\n .find((remote) => remote.meta.collectionId.equals(collectionId));\n if (!existing) {\n await syncManager.add(\n `mcp-remote-${crypto.randomUUID()}`,\n collectionId,\n {\n type: \"gql\",\n parameters: { url: endpoint.href },\n },\n );\n }\n return { driveId: info.id };\n },\n });\n}\n\n/** Drive administration over the full client. `addRemoteDrive` is mounted\n * only when the host allows remote drive URLs and has a sync manager. */\nexport function reactorAdminTools(options: ReactorAdminToolsOptions = {}) {\n const remote =\n options.remoteDriveUrls && options.syncManager\n ? [addRemoteDriveTool(options)]\n : [];\n return [\n addDriveTool(options.gate),\n deleteDriveTool(options.subject, options.gate),\n ...remote,\n ];\n}\n"],"mappings":"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"}
package/dist/cli.mjs CHANGED
@@ -1,4 +1,4 @@
1
- import { n as logger, t as createServer$1 } from "./server-CPSr7how.mjs";
1
+ import { o as logger, t as createServer$1 } from "./server-aC2pHzQO.mjs";
2
2
  import { childLogger, documentModelDocumentModelModule } from "document-model";
3
3
  import { ReactorBuilder, ReactorClientBuilder } from "@powerhousedao/reactor";
4
4
  import { driveDocumentModelModule } from "@powerhousedao/shared/document-drive";
package/dist/index.d.mts CHANGED
@@ -1,37 +1,37 @@
1
- import { C as ResolveZodSchema, D as compactDocumentModelSchema, E as CompactDocumentModelSchema, S as IMcpProvider, T as ToolWithCallback, _ as getDocumentTool, a as ReactorMcpProviderOptions, b as getDrivesTool, c as addDriveTool, d as createReactorMcpProvider, f as deleteDocumentTool, g as getDocumentModelsTool, h as getDocumentModelSchemaTool, i as validateDocumentModelAction, l as addRemoteDriveTool, m as getCodegenStatusTool, n as createBaseAction, o as ReactorMcpTools, p as deleteDriveTool, r as toolWithCallback, s as addActionsTool, t as InvalidToolOutputError, u as createDocumentTool, v as getDocumentsTool, w as ToolSchema, x as ExtractCallbackFromTool, y as getDriveTool } from "./index-D9YfSE7M.mjs";
1
+ import { ANY_SCOPE, ActionError, ActionFailure, ActionInput, ActionResult, AiSdkTool, AiSdkToolSet, AnyToolDefinition, BASE_OPERATIONS, CompactDocumentModelSchema, CreateDocumentInput, CreatedDocument, DEFAULT_BRANCH, DEFAULT_TRIM_LIMITS, DRIVE_DOCUMENT_TYPE, DRIVE_DOCUMENT_TYPES, DocumentModelInfo, DocumentModelSummary, DocumentSummary, DocumentView, DocumentViewOptions, ExecuteActionsOptions, ExecutedActions, GetDocumentOptions, JsonPathError, MAX_FILTERED_CHARS, McpToolRecord, ModelOperation, OperationSlice, REACTOR_TOOL_ERROR_CODES, ReactorTool, ReactorToolAnnotations, ReactorToolClient, ReactorToolError, ReactorToolErrorCode, ReactorToolReadClient, ReactorToolReadMethods, ReactorToolWriteClient, ReactorToolWriteMethods, ReactorToolsOptions, Revision, StateSlice, ToolContext, ToolDefinition, TrimLimits, ValidateActionsOptions, ValidatedActions, actionFailuresError, actionInputSchema, actionOperations, addActionsTool, aliasParam, applyJsonPath, codegenHint, codegenStatusTool, compactDocumentModelSchema, compactDocumentModelSchemaSchema, createAddActionsTool, createDocument, createDocumentTool, defineTool, deleteDocument, deleteDocumentTool, documentModelInfo, documentModelInfoSchema, documentModelSummary, documentModelSummarySchema, documentName, documentSummary, documentSummarySchema, documentView, documentViewSchema, executeActions, executeBuiltActions, formatActionFailures, formatToolError, getDocument, getDocumentModel, getDocumentModelForDocument, getDocumentModelSchemaTool, getDocumentModelsTool, getDocumentTool, getDocumentsTool, getDriveTool, getDrivesTool, isReactorToolError, isWriteTool, latestSpecification, modelOperationSchema, modelOperations, notFound, operationSchemaSlice, operationSliceSchema, parseJsonPath, queryJsonPath, reactorTools, stateSchemaSlice, stateSliceSchema, suggestNames, targetId, targetParam, toAiSdkTools, toMcpTool, toReactorToolError, trimValue, unknownValueMessage, validateActions } from "./tools/index.mjs";
2
+ import { a as HostAccessClient, c as HostAccessIdentity, i as reactorAdminTools, l as McpAccess, n as RemoteDriveAllowlist, o as HostAccessDeniedError, r as isRemoteDriveUrlAllowed, s as HostAccessGate, t as ReactorAdminToolsOptions } from "./admin-tools-B-ZmrfuR.mjs";
2
3
  import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
3
4
  import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
4
- import { IReactorClient, ISyncManager } from "@powerhousedao/reactor";
5
- import { AuthSubject } from "@powerhousedao/shared/document-model";
6
5
  import { CodegenStatusRegistry } from "@powerhousedao/shared/processors";
6
+ import { ConsistencyToken, IReactorClient, ISyncManager, NewDocumentOptions, OperationFilter, PagingOptions, SearchFilter, ViewFilter } from "@powerhousedao/reactor";
7
+ import { AuthSubject, PHDocument } from "@powerhousedao/shared/document-model";
7
8
  import { IncomingMessage, ServerResponse } from "node:http";
8
9
  //#region src/mcp-routes.d.ts
9
10
  /** Minimal interface for an HTTP adapter that supports Node.js-style route handlers. */
10
11
  interface NodeRouteAdapter {
11
12
  mountNodeRoute(method: "DELETE" | "GET" | "POST", path: string, handler: (req: IncomingMessage, res: ServerResponse, body?: unknown) => void | Promise<void>): void;
12
13
  }
13
- /**
14
- * An authorized request names the subject its tools read as. Anonymous is an
15
- * empty subject, never the host's signer.
16
- */
17
- type McpAuthorizationResult = {
18
- authorized: true;
14
+ /** The subject the tools read as (anonymous is `{}`, never the host's signer). */
15
+ type McpGrant = {
19
16
  subject: AuthSubject;
20
- } | {
17
+ access?: McpAccess;
18
+ };
19
+ /** An authorized request names its subject and the host ACL its tools answer to. */
20
+ type McpAuthorizationResult = ({
21
+ authorized: true;
22
+ } & McpGrant) | {
21
23
  authorized: false;
22
24
  status: number;
23
25
  message: string;
24
26
  };
25
- /**
26
- * Authorizes an incoming /mcp request before it reaches the MCP transport.
27
- * MCP tools run with unrestricted reactor access, so this is the only gate;
28
- * an open endpoint must opt in by returning `authorized: true`.
29
- */
27
+ /** Authorizes an /mcp request before the transport; an open endpoint opts in with `authorized: true`. */
30
28
  type McpRequestAuthorizer = (req: IncomingMessage) => Promise<McpAuthorizationResult>;
31
29
  interface SetupMcpServerOptions {
32
30
  client: IReactorClient;
33
31
  syncManager?: ISyncManager;
34
32
  authorizeRequest: McpRequestAuthorizer;
33
+ /** URLs `addRemoteDrive` may fetch; omitted, the tool is not mounted. */
34
+ remoteDriveUrls?: RemoteDriveAllowlist;
35
35
  }
36
36
  /** @internal Injected in tests to avoid relying on constructor mock semantics. */
37
37
  type TransportFactory = (opts: {
@@ -45,11 +45,39 @@ interface CreateServerOptions {
45
45
  syncManager?: ISyncManager;
46
46
  /** Who the tools read as; omitted, the client's signer. */
47
47
  subject?: AuthSubject;
48
+ /** The host's ACL for the caller, in front of every tool; omitted, none. */
49
+ access?: McpAccess;
50
+ /** URLs `addRemoteDrive` may fetch; omitted, the tool is not mounted. */
51
+ remoteDriveUrls?: RemoteDriveAllowlist;
48
52
  /** Vetra's codegen status; the process's registry by default. */
49
53
  codegenStatus?: CodegenStatusRegistry;
50
54
  }
51
55
  export declare function createServer(options: CreateServerOptions): Promise<McpServer>;
52
56
  //#endregion
53
- export { CompactDocumentModelSchema, type CreateServerOptions, ExtractCallbackFromTool, IMcpProvider, InvalidToolOutputError, type McpAuthorizationResult, type McpRequestAuthorizer, ReactorMcpProviderOptions, ReactorMcpTools, ResolveZodSchema, type SetupMcpServerOptions, ToolSchema, ToolWithCallback, addActionsTool, addDriveTool, addRemoteDriveTool, compactDocumentModelSchema, createBaseAction, createDocumentTool, createReactorMcpProvider, deleteDocumentTool, deleteDriveTool, getCodegenStatusTool, getDocumentModelSchemaTool, getDocumentModelsTool, getDocumentTool, getDocumentsTool, getDriveTool, getDrivesTool, toolWithCallback, validateDocumentModelAction };
57
+ //#region src/subject-client.d.ts
58
+ export declare class SubjectScopedClient implements ReactorToolClient {
59
+ private readonly inner;
60
+ private readonly subject?;
61
+ readonly write: ReactorToolWriteClient & {
62
+ evaluateActions: IReactorClient["write"]["evaluateActions"];
63
+ };
64
+ constructor(inner: IReactorClient, subject?: AuthSubject | undefined);
65
+ private view;
66
+ private assertNoHiddenFiling;
67
+ get<T extends PHDocument>(id: string, view?: ViewFilter, signal?: AbortSignal, consistencyToken?: ConsistencyToken): Promise<T>;
68
+ resolveIdOrSlug(id: string, view?: ViewFilter, signal?: AbortSignal, consistencyToken?: ConsistencyToken): Promise<string>;
69
+ find(search: SearchFilter, view?: ViewFilter, paging?: PagingOptions, signal?: AbortSignal, consistencyToken?: ConsistencyToken): Promise<import("@powerhousedao/reactor").PagedResults<PHDocument>>;
70
+ getOperations(id: string, view?: ViewFilter, filter?: OperationFilter, paging?: PagingOptions, signal?: AbortSignal): Promise<import("@powerhousedao/reactor").PagedResults<import("@powerhousedao/shared/document-model").Operation>>;
71
+ getOutgoingRelationships(id: string, type: string, view?: ViewFilter, paging?: PagingOptions, signal?: AbortSignal, consistencyToken?: ConsistencyToken): Promise<import("@powerhousedao/reactor").PagedResults<PHDocument>>;
72
+ getIncomingRelationships(id: string, type: string, view?: ViewFilter, paging?: PagingOptions, signal?: AbortSignal, consistencyToken?: ConsistencyToken): Promise<import("@powerhousedao/reactor").PagedResults<PHDocument>>;
73
+ getOutgoingRelationshipEdges(id: string, type?: string, view?: ViewFilter, paging?: PagingOptions, signal?: AbortSignal, consistencyToken?: ConsistencyToken): Promise<import("@powerhousedao/reactor").PagedResults<import("@powerhousedao/reactor").DocumentRelationship>>;
74
+ getIncomingRelationshipEdges(id: string, type?: string, view?: ViewFilter, paging?: PagingOptions, signal?: AbortSignal, consistencyToken?: ConsistencyToken): Promise<import("@powerhousedao/reactor").PagedResults<import("@powerhousedao/reactor").DocumentRelationship>>;
75
+ getDocumentModelModules(namespace?: string, paging?: PagingOptions, signal?: AbortSignal): Promise<import("@powerhousedao/reactor").PagedResults<import("@powerhousedao/shared/document-model").DocumentModelModule>>;
76
+ getDocumentModelModule(documentType: string): Promise<import("@powerhousedao/shared/document-model").DocumentModelModule<any>>;
77
+ getDocumentModelModuleForDocument(document: PHDocument): Promise<import("@powerhousedao/shared/document-model").DocumentModelModule<any>>;
78
+ newDocument<T extends PHDocument = PHDocument>(documentType: string, options?: NewDocumentOptions, signal?: AbortSignal): Promise<T>;
79
+ }
80
+ //#endregion
81
+ export { ANY_SCOPE, ActionError, ActionFailure, ActionInput, ActionResult, AiSdkTool, AiSdkToolSet, AnyToolDefinition, BASE_OPERATIONS, CompactDocumentModelSchema, CreateDocumentInput, type CreateServerOptions, CreatedDocument, DEFAULT_BRANCH, DEFAULT_TRIM_LIMITS, DRIVE_DOCUMENT_TYPE, DRIVE_DOCUMENT_TYPES, DocumentModelInfo, DocumentModelSummary, DocumentSummary, DocumentView, DocumentViewOptions, ExecuteActionsOptions, ExecutedActions, GetDocumentOptions, HostAccessClient, HostAccessDeniedError, HostAccessGate, type HostAccessIdentity, JsonPathError, MAX_FILTERED_CHARS, type McpAccess, type McpAuthorizationResult, type McpRequestAuthorizer, McpToolRecord, ModelOperation, OperationSlice, REACTOR_TOOL_ERROR_CODES, type ReactorAdminToolsOptions, ReactorTool, ReactorToolAnnotations, ReactorToolClient, ReactorToolError, ReactorToolErrorCode, ReactorToolReadClient, ReactorToolReadMethods, ReactorToolWriteClient, ReactorToolWriteMethods, ReactorToolsOptions, type RemoteDriveAllowlist, Revision, type SetupMcpServerOptions, StateSlice, ToolContext, ToolDefinition, TrimLimits, ValidateActionsOptions, ValidatedActions, actionFailuresError, actionInputSchema, actionOperations, addActionsTool, aliasParam, applyJsonPath, codegenHint, codegenStatusTool, compactDocumentModelSchema, compactDocumentModelSchemaSchema, createAddActionsTool, createDocument, createDocumentTool, defineTool, deleteDocument, deleteDocumentTool, documentModelInfo, documentModelInfoSchema, documentModelSummary, documentModelSummarySchema, documentName, documentSummary, documentSummarySchema, documentView, documentViewSchema, executeActions, executeBuiltActions, formatActionFailures, formatToolError, getDocument, getDocumentModel, getDocumentModelForDocument, getDocumentModelSchemaTool, getDocumentModelsTool, getDocumentTool, getDocumentsTool, getDriveTool, getDrivesTool, isReactorToolError, isRemoteDriveUrlAllowed, isWriteTool, latestSpecification, modelOperationSchema, modelOperations, notFound, operationSchemaSlice, operationSliceSchema, parseJsonPath, queryJsonPath, reactorAdminTools, reactorTools, stateSchemaSlice, stateSliceSchema, suggestNames, targetId, targetParam, toAiSdkTools, toMcpTool, toReactorToolError, trimValue, unknownValueMessage, validateActions };
54
82
  export {};
55
83
  //# sourceMappingURL=index.d.mts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.mts","names":[],"sources":["../src/mcp-routes.ts","../src/server.ts"],"mappings":";;;;;;;;;UAMU;EACR,eACE,mCACA,cACA,UACE,KAAK,iBACL,KAAK,gBACL,0BACU;;;;;;KAUJ;EACN;EAAkB,SAAS;;EAC3B;EAAmB;EAAgB;;;;;;;KAO7B,wBACV,KAAK,oBACF,QAAQ;UAEI;EACf,QAAQ;EACR,cAAc;EACd,kBAAkB;;;KAgBf,oBAAoB;EACvB;MACI,oBAAoB;wBA+CV,eACd,SAAS,uBACT,aAAa,kBAGb,kBAAiB,mBAEhB;;;UC1Gc;EACf,QAAQ;EACR,cAAc;;EAEd,UAAU;;EAEV,gBAAgB;;wBAqBI,aACpB,SAAS,sBACR,QAAQ"}
1
+ {"version":3,"file":"index.d.mts","names":[],"sources":["../src/mcp-routes.ts","../src/server.ts","../src/subject-client.ts"],"mappings":";;;;;;;;;;UAMU;EACR,eACE,mCACA,cACA,UACE,KAAK,iBACL,KAAK,gBACL,0BACU;;;KASX;EAAa,SAAS;EAAa,SAAS;;;KAGrC;EACL;IAAqB;EACtB;EAAmB;EAAgB;;;KAG7B,wBACV,KAAK,oBACF,QAAQ;UAEI;EACf,QAAQ;EACR,cAAc;EACd,kBAAkB;;EAElB,kBAAkB;;;KAgBf,oBAAoB;EACvB;MACI,oBAAoB;wBA+CV,eACd,SAAS,uBACT,aAAa,kBAGb,kBAAiB,mBAEhB;;;UChGc;EACf,QAAQ;EACR,cAAc;;EAEd,UAAU;;EAEV,SAAS;;EAET,kBAAkB;;EAElB,gBAAgB;;wBAqBF,aAAa,SAAS,sBAAsB,QAAQ;;;qBCvBvD,+BAA+B;mBAMvB;mBACA;WANV,OAAO;IACd,iBAAiB;;EAGnB,YACmB,OAAO,gBACP,UAAU;UAuBrB;UAKM;EAuBd,IAAI,UAAU,YACZ,YACA,OAAO,YACP,SAAS,aACT,mBAAmB,mBAAgB,QAAA;EAKrC,gBACE,YACA,OAAO,YACP,SAAS,aACT,mBAAmB,mBAAgB;EAUrC,KACE,QAAQ,cACR,OAAO,YACP,SAAS,eACT,SAAS,aACT,mBAAmB,mBAAgB,yCAAA,aAAA;EAWrC,cACE,YACA,OAAO,YACP,SAAS,iBACT,SAAS,eACT,SAAS,cAAW,yCAAA,4DAAA;EAWtB,yBACE,YACA,cACA,OAAO,YACP,SAAS,eACT,SAAS,aACT,mBAAmB,mBAAgB,yCAAA,aAAA;EAYrC,yBACE,YACA,cACA,OAAO,YACP,SAAS,eACT,SAAS,aACT,mBAAmB,mBAAgB,yCAAA,aAAA;EAYrC,6BACE,YACA,eACA,OAAO,YACP,SAAS,eACT,SAAS,aACT,mBAAmB,mBAAgB,yCAAA,8CAAA;EAYrC,6BACE,YACA,eACA,OAAO,YACP,SAAS,eACT,SAAS,aACT,mBAAmB,mBAAgB,yCAAA,8CAAA;EAYrC,wBACE,oBACA,SAAS,eACT,SAAS,cAAW,yCAAA,4DAAA;EAKtB,uBAAuB,uBAAoB,uDAAA;EAI3C,kCAAkC,UAAU,aAAU,uDAAA;EAItD,YAAY,UAAU,aAAa,YACjC,sBACA,UAAU,oBACV,SAAS,cAAW,QAAA"}
package/dist/index.mjs CHANGED
@@ -1,6 +1,6 @@
1
- import { n as logger, t as createServer } from "./server-CPSr7how.mjs";
2
- import { _ as toolWithCallback, a as createReactorMcpProvider, c as getCodegenStatusTool, d as getDocumentTool, f as getDocumentsTool, g as createBaseAction, h as InvalidToolOutputError, i as createDocumentTool, l as getDocumentModelSchemaTool, m as getDrivesTool, n as addDriveTool, o as deleteDocumentTool, p as getDriveTool, r as addRemoteDriveTool, s as deleteDriveTool, t as addActionsTool, u as getDocumentModelsTool, v as validateDocumentModelAction, y as compactDocumentModelSchema } from "./reactor-Cku02YAV.mjs";
3
- import "./tools/index.mjs";
1
+ import { a as HostAccessGate, i as HostAccessDeniedError, n as SubjectScopedClient, o as logger, r as HostAccessClient, t as createServer } from "./server-aC2pHzQO.mjs";
2
+ import { ANY_SCOPE, BASE_OPERATIONS, DEFAULT_BRANCH, DEFAULT_TRIM_LIMITS, DRIVE_DOCUMENT_TYPE, DRIVE_DOCUMENT_TYPES, JsonPathError, MAX_FILTERED_CHARS, REACTOR_TOOL_ERROR_CODES, ReactorToolError, actionFailuresError, actionInputSchema, actionOperations, addActionsTool, aliasParam, applyJsonPath, codegenHint, codegenStatusTool, compactDocumentModelSchema, compactDocumentModelSchemaSchema, createAddActionsTool, createDocument, createDocumentTool, defineTool, deleteDocument, deleteDocumentTool, documentModelInfo, documentModelInfoSchema, documentModelSummary, documentModelSummarySchema, documentName, documentSummary, documentSummarySchema, documentView, documentViewSchema, executeActions, executeBuiltActions, formatActionFailures, formatToolError, getDocument, getDocumentModel, getDocumentModelForDocument, getDocumentModelSchemaTool, getDocumentModelsTool, getDocumentTool, getDocumentsTool, getDriveTool, getDrivesTool, isReactorToolError, isWriteTool, latestSpecification, modelOperationSchema, modelOperations, notFound, operationSchemaSlice, operationSliceSchema, parseJsonPath, queryJsonPath, reactorTools, stateSchemaSlice, stateSliceSchema, suggestNames, targetId, targetParam, toAiSdkTools, toMcpTool, toReactorToolError, trimValue, unknownValueMessage, validateActions } from "./tools/index.mjs";
3
+ import { isRemoteDriveUrlAllowed, reactorAdminTools } from "./admin-tools.mjs";
4
4
  import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
5
5
  //#region src/mcp-routes.ts
6
6
  function jsonRpcError(message, code = -32e3) {
@@ -34,17 +34,19 @@ function withAuthorization(authorize, handler) {
34
34
  res.writeHead(result.status, { "Content-Type": "application/json" }).end(jsonRpcError(result.message));
35
35
  return;
36
36
  }
37
- await handler(req, res, body, result.subject);
37
+ await handler(req, res, body, result);
38
38
  };
39
39
  }
40
40
  function setupMcpServer(options, httpAdapter, createTransport = (opts) => new StreamableHTTPServerTransport(opts)) {
41
41
  const { authorizeRequest } = options;
42
- httpAdapter.mountNodeRoute("POST", "/mcp", withAuthorization(authorizeRequest, async (req, res, body, subject) => {
42
+ httpAdapter.mountNodeRoute("POST", "/mcp", withAuthorization(authorizeRequest, async (req, res, body, grant) => {
43
43
  try {
44
44
  const server = await createServer({
45
45
  client: options.client,
46
46
  syncManager: options.syncManager,
47
- subject
47
+ subject: grant.subject,
48
+ access: grant.access,
49
+ remoteDriveUrls: options.remoteDriveUrls
48
50
  });
49
51
  const transport = createTransport({ sessionIdGenerator: void 0 });
50
52
  res.on("close", () => {
@@ -67,6 +69,6 @@ function setupMcpServer(options, httpAdapter, createTransport = (opts) => new St
67
69
  return Promise.resolve();
68
70
  }
69
71
  //#endregion
70
- export { InvalidToolOutputError, addActionsTool, addDriveTool, addRemoteDriveTool, compactDocumentModelSchema, createBaseAction, createDocumentTool, createReactorMcpProvider, createServer, deleteDocumentTool, deleteDriveTool, getCodegenStatusTool, getDocumentModelSchemaTool, getDocumentModelsTool, getDocumentTool, getDocumentsTool, getDriveTool, getDrivesTool, setupMcpServer, toolWithCallback, validateDocumentModelAction };
72
+ export { ANY_SCOPE, BASE_OPERATIONS, DEFAULT_BRANCH, DEFAULT_TRIM_LIMITS, DRIVE_DOCUMENT_TYPE, DRIVE_DOCUMENT_TYPES, HostAccessClient, HostAccessDeniedError, HostAccessGate, JsonPathError, MAX_FILTERED_CHARS, REACTOR_TOOL_ERROR_CODES, ReactorToolError, SubjectScopedClient, actionFailuresError, actionInputSchema, actionOperations, addActionsTool, aliasParam, applyJsonPath, codegenHint, codegenStatusTool, compactDocumentModelSchema, compactDocumentModelSchemaSchema, createAddActionsTool, createDocument, createDocumentTool, createServer, defineTool, deleteDocument, deleteDocumentTool, documentModelInfo, documentModelInfoSchema, documentModelSummary, documentModelSummarySchema, documentName, documentSummary, documentSummarySchema, documentView, documentViewSchema, executeActions, executeBuiltActions, formatActionFailures, formatToolError, getDocument, getDocumentModel, getDocumentModelForDocument, getDocumentModelSchemaTool, getDocumentModelsTool, getDocumentTool, getDocumentsTool, getDriveTool, getDrivesTool, isReactorToolError, isRemoteDriveUrlAllowed, isWriteTool, latestSpecification, modelOperationSchema, modelOperations, notFound, operationSchemaSlice, operationSliceSchema, parseJsonPath, queryJsonPath, reactorAdminTools, reactorTools, setupMcpServer, stateSchemaSlice, stateSliceSchema, suggestNames, targetId, targetParam, toAiSdkTools, toMcpTool, toReactorToolError, trimValue, unknownValueMessage, validateActions };
71
73
 
72
74
  //# sourceMappingURL=index.mjs.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.mjs","names":[],"sources":["../src/mcp-routes.ts"],"sourcesContent":["import { StreamableHTTPServerTransport } from \"@modelcontextprotocol/sdk/server/streamableHttp.js\";\nimport type { IReactorClient, ISyncManager } from \"@powerhousedao/reactor\";\nimport type { AuthSubject } from \"@powerhousedao/shared/document-model\";\nimport type { IncomingMessage, ServerResponse } from \"node:http\";\n\n/** Minimal interface for an HTTP adapter that supports Node.js-style route handlers. */\ninterface NodeRouteAdapter {\n mountNodeRoute(\n method: \"DELETE\" | \"GET\" | \"POST\",\n path: string,\n handler: (\n req: IncomingMessage,\n res: ServerResponse,\n body?: unknown,\n ) => void | Promise<void>,\n ): void;\n}\nimport { logger } from \"./logger.js\";\nimport { createServer } from \"./server.js\";\n\n/**\n * An authorized request names the subject its tools read as. Anonymous is an\n * empty subject, never the host's signer.\n */\nexport type McpAuthorizationResult =\n | { authorized: true; subject: AuthSubject }\n | { authorized: false; status: number; message: string };\n\n/**\n * Authorizes an incoming /mcp request before it reaches the MCP transport.\n * MCP tools run with unrestricted reactor access, so this is the only gate;\n * an open endpoint must opt in by returning `authorized: true`.\n */\nexport type McpRequestAuthorizer = (\n req: IncomingMessage,\n) => Promise<McpAuthorizationResult>;\n\nexport interface SetupMcpServerOptions {\n client: IReactorClient;\n syncManager?: ISyncManager;\n authorizeRequest: McpRequestAuthorizer;\n}\n\nfunction jsonRpcError(message: string, code = -32000): string {\n return JSON.stringify({\n jsonrpc: \"2.0\",\n error: { code, message },\n id: null,\n });\n}\n\nconst METHOD_NOT_ALLOWED = jsonRpcError(\"Method not allowed.\");\n\nconst INTERNAL_SERVER_ERROR = jsonRpcError(\"Internal server error\", -32603);\n\n/** @internal Injected in tests to avoid relying on constructor mock semantics. */\ntype TransportFactory = (opts: {\n sessionIdGenerator: undefined;\n}) => InstanceType<typeof StreamableHTTPServerTransport>;\n\ntype NodeRouteHandler = (\n req: IncomingMessage,\n res: ServerResponse,\n body?: unknown,\n) => void | Promise<void>;\n\ntype AuthorizedRouteHandler = (\n req: IncomingMessage,\n res: ServerResponse,\n body: unknown,\n subject: AuthSubject,\n) => void | Promise<void>;\n\n/**\n * Authorizes the request before running the handler. Failures respond with\n * the authorizer's status and a JSON-RPC error; an authorizer fault fails\n * closed with a 500.\n */\nfunction withAuthorization(\n authorize: McpRequestAuthorizer,\n handler: AuthorizedRouteHandler,\n): NodeRouteHandler {\n return async (req: IncomingMessage, res: ServerResponse, body?: unknown) => {\n let result: McpAuthorizationResult;\n try {\n result = await authorize(req);\n } catch (error) {\n logger.error(\"Error authorizing MCP request: @error\", error);\n if (!res.headersSent) {\n res\n .writeHead(500, { \"Content-Type\": \"application/json\" })\n .end(INTERNAL_SERVER_ERROR);\n }\n return;\n }\n if (!result.authorized) {\n res\n .writeHead(result.status, { \"Content-Type\": \"application/json\" })\n .end(jsonRpcError(result.message));\n return;\n }\n await handler(req, res, body, result.subject);\n };\n}\n\nexport function setupMcpServer(\n options: SetupMcpServerOptions,\n httpAdapter: NodeRouteAdapter,\n // Allow tests to inject a factory function instead of relying on `new vi.fn()`\n // constructor semantics, which differ between macOS and Linux environments.\n createTransport: TransportFactory = (opts) =>\n new StreamableHTTPServerTransport(opts),\n): Promise<void> {\n const { authorizeRequest } = options;\n\n httpAdapter.mountNodeRoute(\n \"POST\",\n \"/mcp\",\n withAuthorization(authorizeRequest, async (req, res, body, subject) => {\n // Stateless mode: every request owns its McpServer + transport so\n // concurrent or slow handlers cannot collide on a shared Protocol\n // instance (which throws \"Already connected to a transport\").\n try {\n const server = await createServer({\n client: options.client,\n syncManager: options.syncManager,\n subject,\n });\n const transport = createTransport({ sessionIdGenerator: undefined });\n res.on(\"close\", () => {\n void transport.close();\n void server.close();\n });\n await server.connect(transport);\n await transport.handleRequest(req, res, body);\n } catch (error) {\n logger.error(\"Error handling MCP request: @error\", error);\n if (!res.headersSent) {\n res\n .writeHead(500, { \"Content-Type\": \"application/json\" })\n .end(INTERNAL_SERVER_ERROR);\n }\n }\n }),\n );\n\n // GET/DELETE always answer 405 in stateless mode and reach no MCP tool, so\n // they are intentionally left unauthorized.\n httpAdapter.mountNodeRoute(\n \"GET\",\n \"/mcp\",\n (_req: IncomingMessage, res: ServerResponse) => {\n res.writeHead(405).end(METHOD_NOT_ALLOWED);\n },\n );\n\n httpAdapter.mountNodeRoute(\n \"DELETE\",\n \"/mcp\",\n (_req: IncomingMessage, res: ServerResponse) => {\n res.writeHead(405).end(METHOD_NOT_ALLOWED);\n },\n );\n return Promise.resolve();\n}\n"],"mappings":";;;;;AA2CA,SAAS,aAAa,SAAiB,OAAO,OAAgB;CAC5D,OAAO,KAAK,UAAU;EACpB,SAAS;EACT,OAAO;GAAE;GAAM;EAAQ;EACvB,IAAI;CACN,CAAC;AACH;AAEA,MAAM,qBAAqB,aAAa,qBAAqB;AAE7D,MAAM,wBAAwB,aAAa,yBAAyB,MAAM;;;;;;AAyB1E,SAAS,kBACP,WACA,SACkB;CAClB,OAAO,OAAO,KAAsB,KAAqB,SAAmB;EAC1E,IAAI;EACJ,IAAI;GACF,SAAS,MAAM,UAAU,GAAG;EAC9B,SAAS,OAAO;GACd,OAAO,MAAM,yCAAyC,KAAK;GAC3D,IAAI,CAAC,IAAI,aACP,IACG,UAAU,KAAK,EAAE,gBAAgB,mBAAmB,CAAC,CAAC,CACtD,IAAI,qBAAqB;GAE9B;EACF;EACA,IAAI,CAAC,OAAO,YAAY;GACtB,IACG,UAAU,OAAO,QAAQ,EAAE,gBAAgB,mBAAmB,CAAC,CAAC,CAChE,IAAI,aAAa,OAAO,OAAO,CAAC;GACnC;EACF;EACA,MAAM,QAAQ,KAAK,KAAK,MAAM,OAAO,OAAO;CAC9C;AACF;AAEA,SAAgB,eACd,SACA,aAGA,mBAAqC,SACnC,IAAI,8BAA8B,IAAI,GACzB;CACf,MAAM,EAAE,qBAAqB;CAE7B,YAAY,eACV,QACA,QACA,kBAAkB,kBAAkB,OAAO,KAAK,KAAK,MAAM,YAAY;EAIrE,IAAI;GACF,MAAM,SAAS,MAAM,aAAa;IAChC,QAAQ,QAAQ;IAChB,aAAa,QAAQ;IACrB;GACF,CAAC;GACD,MAAM,YAAY,gBAAgB,EAAE,oBAAoB,KAAA,EAAU,CAAC;GACnE,IAAI,GAAG,eAAe;IACpB,UAAe,MAAM;IACrB,OAAY,MAAM;GACpB,CAAC;GACD,MAAM,OAAO,QAAQ,SAAS;GAC9B,MAAM,UAAU,cAAc,KAAK,KAAK,IAAI;EAC9C,SAAS,OAAO;GACd,OAAO,MAAM,sCAAsC,KAAK;GACxD,IAAI,CAAC,IAAI,aACP,IACG,UAAU,KAAK,EAAE,gBAAgB,mBAAmB,CAAC,CAAC,CACtD,IAAI,qBAAqB;EAEhC;CACF,CAAC,CACH;CAIA,YAAY,eACV,OACA,SACC,MAAuB,QAAwB;EAC9C,IAAI,UAAU,GAAG,CAAC,CAAC,IAAI,kBAAkB;CAC3C,CACF;CAEA,YAAY,eACV,UACA,SACC,MAAuB,QAAwB;EAC9C,IAAI,UAAU,GAAG,CAAC,CAAC,IAAI,kBAAkB;CAC3C,CACF;CACA,OAAO,QAAQ,QAAQ;AACzB"}
1
+ {"version":3,"file":"index.mjs","names":[],"sources":["../src/mcp-routes.ts"],"sourcesContent":["import { StreamableHTTPServerTransport } from \"@modelcontextprotocol/sdk/server/streamableHttp.js\";\nimport type { IReactorClient, ISyncManager } from \"@powerhousedao/reactor\";\nimport type { AuthSubject } from \"@powerhousedao/shared/document-model\";\nimport type { IncomingMessage, ServerResponse } from \"node:http\";\n\n/** Minimal interface for an HTTP adapter that supports Node.js-style route handlers. */\ninterface NodeRouteAdapter {\n mountNodeRoute(\n method: \"DELETE\" | \"GET\" | \"POST\",\n path: string,\n handler: (\n req: IncomingMessage,\n res: ServerResponse,\n body?: unknown,\n ) => void | Promise<void>,\n ): void;\n}\nimport type { RemoteDriveAllowlist } from \"./admin-tools.js\";\nimport type { McpAccess } from \"./host-access.js\";\nimport { logger } from \"./logger.js\";\nimport { createServer } from \"./server.js\";\n\n/** The subject the tools read as (anonymous is `{}`, never the host's signer). */\ntype McpGrant = { subject: AuthSubject; access?: McpAccess };\n\n/** An authorized request names its subject and the host ACL its tools answer to. */\nexport type McpAuthorizationResult =\n | ({ authorized: true } & McpGrant)\n | { authorized: false; status: number; message: string };\n\n/** Authorizes an /mcp request before the transport; an open endpoint opts in with `authorized: true`. */\nexport type McpRequestAuthorizer = (\n req: IncomingMessage,\n) => Promise<McpAuthorizationResult>;\n\nexport interface SetupMcpServerOptions {\n client: IReactorClient;\n syncManager?: ISyncManager;\n authorizeRequest: McpRequestAuthorizer;\n /** URLs `addRemoteDrive` may fetch; omitted, the tool is not mounted. */\n remoteDriveUrls?: RemoteDriveAllowlist;\n}\n\nfunction jsonRpcError(message: string, code = -32000): string {\n return JSON.stringify({\n jsonrpc: \"2.0\",\n error: { code, message },\n id: null,\n });\n}\n\nconst METHOD_NOT_ALLOWED = jsonRpcError(\"Method not allowed.\");\n\nconst INTERNAL_SERVER_ERROR = jsonRpcError(\"Internal server error\", -32603);\n\n/** @internal Injected in tests to avoid relying on constructor mock semantics. */\ntype TransportFactory = (opts: {\n sessionIdGenerator: undefined;\n}) => InstanceType<typeof StreamableHTTPServerTransport>;\n\ntype NodeRouteHandler = (\n req: IncomingMessage,\n res: ServerResponse,\n body?: unknown,\n) => void | Promise<void>;\n\ntype AuthorizedRouteHandler = (\n req: IncomingMessage,\n res: ServerResponse,\n body: unknown,\n grant: McpGrant,\n) => void | Promise<void>;\n\n/**\n * Authorizes the request before running the handler. Failures respond with\n * the authorizer's status and a JSON-RPC error; an authorizer fault fails\n * closed with a 500.\n */\nfunction withAuthorization(\n authorize: McpRequestAuthorizer,\n handler: AuthorizedRouteHandler,\n): NodeRouteHandler {\n return async (req: IncomingMessage, res: ServerResponse, body?: unknown) => {\n let result: McpAuthorizationResult;\n try {\n result = await authorize(req);\n } catch (error) {\n logger.error(\"Error authorizing MCP request: @error\", error);\n if (!res.headersSent) {\n res\n .writeHead(500, { \"Content-Type\": \"application/json\" })\n .end(INTERNAL_SERVER_ERROR);\n }\n return;\n }\n if (!result.authorized) {\n res\n .writeHead(result.status, { \"Content-Type\": \"application/json\" })\n .end(jsonRpcError(result.message));\n return;\n }\n await handler(req, res, body, result);\n };\n}\n\nexport function setupMcpServer(\n options: SetupMcpServerOptions,\n httpAdapter: NodeRouteAdapter,\n // Allow tests to inject a factory function instead of relying on `new vi.fn()`\n // constructor semantics, which differ between macOS and Linux environments.\n createTransport: TransportFactory = (opts) =>\n new StreamableHTTPServerTransport(opts),\n): Promise<void> {\n const { authorizeRequest } = options;\n\n httpAdapter.mountNodeRoute(\n \"POST\",\n \"/mcp\",\n withAuthorization(authorizeRequest, async (req, res, body, grant) => {\n // Stateless mode: every request owns its McpServer + transport so\n // concurrent or slow handlers cannot collide on a shared Protocol\n // instance (which throws \"Already connected to a transport\").\n try {\n const server = await createServer({\n client: options.client,\n syncManager: options.syncManager,\n subject: grant.subject,\n access: grant.access,\n remoteDriveUrls: options.remoteDriveUrls,\n });\n const transport = createTransport({ sessionIdGenerator: undefined });\n res.on(\"close\", () => {\n void transport.close();\n void server.close();\n });\n await server.connect(transport);\n await transport.handleRequest(req, res, body);\n } catch (error) {\n logger.error(\"Error handling MCP request: @error\", error);\n if (!res.headersSent) {\n res\n .writeHead(500, { \"Content-Type\": \"application/json\" })\n .end(INTERNAL_SERVER_ERROR);\n }\n }\n }),\n );\n\n // GET/DELETE always answer 405 in stateless mode and reach no MCP tool, so\n // they are intentionally left unauthorized.\n httpAdapter.mountNodeRoute(\n \"GET\",\n \"/mcp\",\n (_req: IncomingMessage, res: ServerResponse) => {\n res.writeHead(405).end(METHOD_NOT_ALLOWED);\n },\n );\n\n httpAdapter.mountNodeRoute(\n \"DELETE\",\n \"/mcp\",\n (_req: IncomingMessage, res: ServerResponse) => {\n res.writeHead(405).end(METHOD_NOT_ALLOWED);\n },\n );\n return Promise.resolve();\n}\n"],"mappings":";;;;;AA2CA,SAAS,aAAa,SAAiB,OAAO,OAAgB;CAC5D,OAAO,KAAK,UAAU;EACpB,SAAS;EACT,OAAO;GAAE;GAAM;EAAQ;EACvB,IAAI;CACN,CAAC;AACH;AAEA,MAAM,qBAAqB,aAAa,qBAAqB;AAE7D,MAAM,wBAAwB,aAAa,yBAAyB,MAAM;;;;;;AAyB1E,SAAS,kBACP,WACA,SACkB;CAClB,OAAO,OAAO,KAAsB,KAAqB,SAAmB;EAC1E,IAAI;EACJ,IAAI;GACF,SAAS,MAAM,UAAU,GAAG;EAC9B,SAAS,OAAO;GACd,OAAO,MAAM,yCAAyC,KAAK;GAC3D,IAAI,CAAC,IAAI,aACP,IACG,UAAU,KAAK,EAAE,gBAAgB,mBAAmB,CAAC,CAAC,CACtD,IAAI,qBAAqB;GAE9B;EACF;EACA,IAAI,CAAC,OAAO,YAAY;GACtB,IACG,UAAU,OAAO,QAAQ,EAAE,gBAAgB,mBAAmB,CAAC,CAAC,CAChE,IAAI,aAAa,OAAO,OAAO,CAAC;GACnC;EACF;EACA,MAAM,QAAQ,KAAK,KAAK,MAAM,MAAM;CACtC;AACF;AAEA,SAAgB,eACd,SACA,aAGA,mBAAqC,SACnC,IAAI,8BAA8B,IAAI,GACzB;CACf,MAAM,EAAE,qBAAqB;CAE7B,YAAY,eACV,QACA,QACA,kBAAkB,kBAAkB,OAAO,KAAK,KAAK,MAAM,UAAU;EAInE,IAAI;GACF,MAAM,SAAS,MAAM,aAAa;IAChC,QAAQ,QAAQ;IAChB,aAAa,QAAQ;IACrB,SAAS,MAAM;IACf,QAAQ,MAAM;IACd,iBAAiB,QAAQ;GAC3B,CAAC;GACD,MAAM,YAAY,gBAAgB,EAAE,oBAAoB,KAAA,EAAU,CAAC;GACnE,IAAI,GAAG,eAAe;IACpB,UAAe,MAAM;IACrB,OAAY,MAAM;GACpB,CAAC;GACD,MAAM,OAAO,QAAQ,SAAS;GAC9B,MAAM,UAAU,cAAc,KAAK,KAAK,IAAI;EAC9C,SAAS,OAAO;GACd,OAAO,MAAM,sCAAsC,KAAK;GACxD,IAAI,CAAC,IAAI,aACP,IACG,UAAU,KAAK,EAAE,gBAAgB,mBAAmB,CAAC,CAAC,CACtD,IAAI,qBAAqB;EAEhC;CACF,CAAC,CACH;CAIA,YAAY,eACV,OACA,SACC,MAAuB,QAAwB;EAC9C,IAAI,UAAU,GAAG,CAAC,CAAC,IAAI,kBAAkB;CAC3C,CACF;CAEA,YAAY,eACV,UACA,SACC,MAAuB,QAAwB;EAC9C,IAAI,UAAU,GAAG,CAAC,CAAC,IAAI,kBAAkB;CAC3C,CACF;CACA,OAAO,QAAQ,QAAQ;AACzB"}