@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.
- package/dist/admin-tools-B-ZmrfuR.d.mts +131 -0
- package/dist/admin-tools-B-ZmrfuR.d.mts.map +1 -0
- package/dist/admin-tools.d.mts +3 -0
- package/dist/admin-tools.mjs +192 -0
- package/dist/admin-tools.mjs.map +1 -0
- package/dist/cli.mjs +1 -1
- package/dist/index.d.mts +44 -16
- package/dist/index.d.mts.map +1 -1
- package/dist/index.mjs +9 -7
- package/dist/index.mjs.map +1 -1
- package/dist/server-aC2pHzQO.mjs +329 -0
- package/dist/server-aC2pHzQO.mjs.map +1 -0
- package/dist/tools/index.d.mts +761 -2
- package/dist/tools/index.d.mts.map +1 -0
- package/dist/tools/index.mjs +1555 -2
- package/dist/tools/index.mjs.map +1 -0
- package/package.json +11 -6
- package/dist/index-D9YfSE7M.d.mts +0 -865
- package/dist/index-D9YfSE7M.d.mts.map +0 -1
- package/dist/reactor-Cku02YAV.mjs +0 -743
- package/dist/reactor-Cku02YAV.mjs.map +0 -1
- package/dist/server-CPSr7how.mjs +0 -61
- package/dist/server-CPSr7how.mjs.map +0 -1
|
@@ -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,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":";;;;;AA+BA,SAAS,WAKP,YACyC;CACzC,OAAO;AACT;AAkBA,SAAS,SAAS,OAAoB;CACpC,IAAI;EACF,OAAO,IAAI,IAAI,KAAK;CACtB,QAAQ;EACN,MAAM,IAAI,iBAAiB,kBAAkB,gBAAgB,OAAO;CACtE;AACF;AAEA,SAAgB,wBACd,KACA,OACS;CACT,IAAI,IAAI,aAAa,WAAW,IAAI,aAAa,UAAU,OAAO;CAClE,IAAI,CAAC,OAAO,OAAO;CACnB,IAAI,UAAU,KAAK,OAAO;CAC1B,IAAI,OAAO,UAAU,YAAY,OAAO,MAAM,GAAG;CACjD,OAAO,MAAM,MAAM,UAAU;EAE3B,IAAI,iBAAiB,QACnB,OAAO,IAAI,OAAO,MAAM,QAAQ,MAAM,MAAM,QAAQ,SAAS,EAAE,CAAC,CAAC,CAAC,KAChE,IAAI,IACN;EAEF,MAAM,UAAU,SAAS,KAAK;EAC9B,IAAI,QAAQ,WAAW,IAAI,QAAQ,OAAO;EAE1C,MAAM,SAAS,QAAQ,SAAS,QAAQ,QAAQ,EAAE;EAClD,OACE,WAAW,MACX,IAAI,aAAa,UACjB,IAAI,SAAS,WAAW,GAAG,OAAO,EAAE;CAExC,CAAC;AACH;AAEA,MAAM,QAAQ;CACZ,cAAc;CACd,iBAAiB;CACjB,eAAe;AACjB;;AAGA,SAAS,WACP,OACA,QACe;CACf,MAAM,QAAQ,IAAI,IAChB,OAAO,QAAQ,UAAsB,SAAS,QAAQ,UAAU,EAAE,CACpE;CACA,IAAI,MAAM,OAAO,GACf,MAAM,IAAI,iBACR,kBACA,uCAAuC,MAAM,mCAC/C;CAEF,MAAM,CAAC,SAAS;CAChB,OAAO;AACT;AAEA,MAAM,YAAY,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,eAAe;AAC3E,MAAM,uBAAuB,EAC1B,OAAO,CAAC,CACR,SAAS,CAAC,CACV,SAAS,+DAA+D;AAE3E,MAAM,gBAAgB,SACpB,WAAW;CACT,MAAM;CACN,OAAO;CACP,aACE;CACF,aAAa,EAAE,OAAO;EACpB,MAAM,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS,8BAA8B;EACnE,MAAM;EACN,iBAAiB;EACjB,YAAY,EACT,OAAO;GACN,MAAM,EAAE,OAAO,CAAC,CAAC,SAAS;GAC1B,MAAM;GACN,QAAQ,EACL,OAAO;IACN,MAAM,EAAE,OAAO,CAAC,CAAC,SAAS,mBAAmB;IAC7C,MAAM;GACR,CAAC,CAAC,CACD,SAAS;GACZ,iBAAiB;GACjB,OAAO,EACJ,OAAO;IACN,kBAAkB,EAAE,QAAQ,CAAC,CAAC,SAAS;IACvC,aAAa,EAAE,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,SAAS;GAC9C,CAAC,CAAC,CACD,SAAS;EACd,CAAC,CAAC,CACD,SAAS,CAAC,CACV,SACC,oEACF;CACJ,CAAC;CACD,cAAc,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;CAC9C,aAAa;CACb,MAAM,QAAQ,MAAM,EAAE,QAAQ,UAAU;EACtC,MAAM,EAAE,eAAe;EACvB,MAAM,OAAO,WAAW,QAAQ;GAC9B,KAAK;GACL,YAAY;GACZ,YAAY,QAAQ;EACtB,CAAC;EACD,IAAI,CAAC,MACH,MAAM,IAAI,iBACR,kBACA,mCACF;EAEF,MAAM,OAAO,WAAW,QAAQ;GAC9B,KAAK;GACL,YAAY;GACZ,YAAY,QAAQ;EACtB,CAAC;EACD,MAAM,kBAAkB,WAAW,mBAAmB,CACpD,KAAK,iBACL,YAAY,eACd,CAAC;EAED,MAAM,MAAM,OAAO,KAAA,GAAW,MAAM;EACpC,IAAI;GAMF,MAAM,EAAE,YAAY,YAAY,OAAM,MALhB,OAAO,MAAM,YACjC,qBACA,CAAC,GACD,MACF,EAAA,CAC8C;GAC9C,MAAM,MAAM,QAAQ,OAAO;GAC3B,MAAM,MAAM,MAAM,SAAS,MAAM;GAEjC,IAAI,iBAOF,OAAM,MANe,OAAO,MAAM,mBAChC,SACA,iBACA,KAAA,GACA,MACF,EAAA,CACa;GAQf,OAAM,MANgB,OAAO,MAAM,OACjC,SACA,MACA,KAAA,GACA,MACF,EAAA,CACc;GACd,MAAM,UAAoB,CAAC,aAAa,EAAE,KAAK,CAAC,CAAC;GACjD,IAAI,MACF,QAAQ,KAAK,aAAa,EAAE,KAAK,CAAC,CAAC;GAErC,IAAI,YAAY,OAAO,aACrB,QAAQ,KAAK,eAAe,EAAE,MAAM,WAAW,MAAM,YAAY,CAAC,CAAC;GAErE,IAAI,YAAY,OAAO,qBAAqB,KAAA,GAC1C,QAAQ,KACN,oBAAoB,EAClB,kBAAkB,WAAW,MAAM,iBACrC,CAAC,CACH;GAEF,MAAM,MAAM,OAAO,SAAS,SAAS,MAAM;GAC3C,MAAM,UAAU,MAAM,YAAY,QAAQ,SAAS,MAAM;GACzD,MAAM,oBAAoB,QAAQ,SAAS,SAAS,EAAE,OAAO,CAAC;GAC9D,OAAO,EAAE,QAAQ;EACnB,SAAS,OAAO;GACd,MAAM,mBAAmB,KAAK;EAChC;CACF;AACF,CAAC;AAEH,SAAS,gBACP,SACA,MACA;CACA,OAAO,WAAW;EAChB,MAAM;EACN,OAAO;EACP,aAAa;EACb,aAAa,EAAE,OAAO;GACpB,YAAY,YAAY,iBAAiB;GACzC,SAAS;GACT,IAAI;EACN,CAAC;EACD,cAAc,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;EAC9C,aAAa;GACX,cAAc;GACd,iBAAiB;GACjB,eAAe;EACjB;EACA,MAAM,QAAQ,MAAM,EAAE,QAAQ,UAAU;GACtC,MAAM,SAAS,SAAS,eAAe,MAAM,CAAC,WAAW,IAAI,CAAC;GAE9D,MAAM,UAAU,OAAO,MAAM,KAAK,MAAM,QAAQ,MAAM,IAAI;GAE1D,IAAI;GACJ,IAAI;IACF,QAAQ,MAAM,OAAO,IACnB,SACA,UAAU,EAAE,QAAQ,IAAI,KAAA,GACxB,MACF;GACF,SAAS,OAAO;IACd,MAAM,mBAAmB,OAAO,WAAW;GAC7C;GACA,IAAI,CAAC,8BAA8B,IAAI,MAAM,OAAO,YAAY,GAC9D,MAAM,IAAI,iBACR,kBACA,GAAG,QAAQ,QAAQ,MAAM,OAAO,aAAa,kCAC/C;GAEF,IAAI,CAAE,MAAM,MAA+B,QACzC,MAAM,IAAI,iBACR,aACA,yBAAyB,MAAM,OAAO,GAAG,0BAC3C;GAEF,IAAI;IAMF,OAAM,MALgB,OAAO,MAAM,eACjC,MAAM,OAAO,IACb,KAAA,GACA,MACF,EAAA,CACc;GAChB,SAAS,OAAO;IACd,MAAM,mBAAmB,KAAK;GAChC;GACA,OAAO,EAAE,SAAS,MAAM,OAAO,GAAG;EACpC;CACF,CAAC;AACH;AAEA,SAAS,mBAAmB,SAAmC;CAC7D,OAAO,WAAW;EAChB,MAAM;EACN,OAAO;EACP,aACE;EACF,aAAa,EAAE,OAAO,EACpB,KAAK,EAAE,OAAO,CAAC,CAAC,SAAS,yBAAyB,EACpD,CAAC;EACD,cAAc,EAAE,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;EAC9C,aAAa;GACX,cAAc;GACd,iBAAiB;GACjB,eAAe;EACjB;EACA,MAAM,QAAQ,MAAM,EAAE,UAAU;GAC9B,MAAM,EAAE,aAAa,iBAAiB,SAAS;GAE/C,IAAI,QAAQ,CAAC,KAAK,cAChB,MAAM,IAAI,iBACR,aACA,4DACF;GAEF,IAAI,CAAC,aACH,MAAM,IAAI,iBACR,aACA,kEACF;GAEF,MAAM,MAAM,SAAS,KAAK,GAAG;GAC7B,IAAI,CAAC,wBAAwB,KAAK,eAAe,GAC/C,MAAM,IAAI,iBACR,aACA,uCAAuC,IAAI,QAC7C;GAGF,MAAM,WAAW,MAAM,MAAM,KAAK;IAAE;IAAQ,UAAU;GAAS,CAAC;GAChE,IACE,SAAS,SAAS,oBACjB,SAAS,UAAU,OAAO,SAAS,SAAS,KAE7C,MAAM,IAAI,iBACR,aACA,GAAG,IAAI,KAAK,wCACd;GAEF,IAAI,CAAC,SAAS,IACZ,MAAM,IAAI,iBACR,SAAS,WAAW,MAAM,cAAc,YACxC,qCAAqC,IAAI,KAAK,SAAS,SAAS,QAClE;GAEF,MAAM,OAAQ,MAAM,SAAS,KAAK;GAIlC,IACE,OAAO,KAAK,OAAO,YACnB,OAAO,KAAK,oBAAoB,UAEhC,MAAM,IAAI,iBACR,aACA,GAAG,IAAI,KAAK,0BACd;GAEF,IAAI;GACJ,IAAI;IACF,WAAW,IAAI,IAAI,KAAK,iBAAiB,GAAG;GAC9C,QAAQ;IACN,MAAM,IAAI,iBACR,aACA,GAAG,IAAI,KAAK,kCACd;GACF;GACA,IAAI,CAAC,wBAAwB,UAAU,eAAe,GACpD,MAAM,IAAI,iBACR,aACA,2CAA2C,SAAS,QACtD;GAEF,MAAM,eAAe,kBAAkB,SAAS,KAAK,EAAE;GAIvD,IAAI,CAHa,YACd,KAAK,CAAC,CACN,MAAM,WAAW,OAAO,KAAK,aAAa,OAAO,YAAY,CACpD,GACV,MAAM,YAAY,IAChB,cAAc,OAAO,WAAW,KAChC,cACA;IACE,MAAM;IACN,YAAY,EAAE,KAAK,SAAS,KAAK;GACnC,CACF;GAEF,OAAO,EAAE,SAAS,KAAK,GAAG;EAC5B;CACF,CAAC;AACH;;;AAIA,SAAgB,kBAAkB,UAAoC,CAAC,GAAG;CACxE,MAAM,SACJ,QAAQ,mBAAmB,QAAQ,cAC/B,CAAC,mBAAmB,OAAO,CAAC,IAC5B,CAAC;CACP,OAAO;EACL,aAAa,QAAQ,IAAI;EACzB,gBAAgB,QAAQ,SAAS,QAAQ,IAAI;EAC7C,GAAG;CACL;AACF"}
|
package/dist/cli.mjs
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import {
|
|
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 {
|
|
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
|
-
|
|
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
|
-
|
|
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
|
package/dist/index.d.mts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"index.d.mts","names":[],"sources":["../src/mcp-routes.ts","../src/server.ts"],"mappings":"
|
|
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-
|
|
2
|
-
import {
|
|
3
|
-
import "./tools
|
|
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
|
|
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,
|
|
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 {
|
|
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
|
package/dist/index.mjs.map
CHANGED
|
@@ -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
|
|
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"}
|