@opendatalabs/personal-server-ts-server 0.2.0 → 1.1.0

package/dist/routes/health.js.map

@@ -1 +1 @@
-{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/routes/health.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAiB5B,MAAM,UAAU,WAAW,CAAC,IAAgB;IAC1C,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IAEvB,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QACvD,IAAI,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,IAAI,IAAI,CAAC;QAE/C,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBACnE,QAAQ,GAAG,MAAM,EAAE,EAAE,IAAI,IAAI,CAAC;YAChC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,iEAAiE;gBACjE,QAAQ,GAAG,IAAI,CAAC;gBAChB,IAAI,CAAC,MAAM,EAAE,KAAK,CAChB,EAAE,GAAG,EAAE,aAAa,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,EAC7C,2CAA2C,CAC5C,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ;YAC5B,CAAC,CAAC;gBACE,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAC9B,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS;gBAClC,QAAQ;aACT;YACH,CAAC,CAAC,IAAI,CAAC;QAET,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,EAAE,EAAE,IAAI,IAAI,CAAC;QAEhD,OAAO,CAAC,CAAC,IAAI,CAAC;YACZ,MAAM,EAAE,SAAS;YACjB,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;YACnC,KAAK,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI;YAC/B,QAAQ;YACR,MAAM;SACP,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"health.js","sourceRoot":"","sources":["../../src/routes/health.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAwB5B,MAAM,UAAU,WAAW,CAAC,IAAgB;IAC1C,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IAEvB,GAAG,CAAC,GAAG,CAAC,SAAS,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE;QAC7B,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;QACvD,IAAI,QAAQ,GAAG,IAAI,CAAC,QAAQ,EAAE,QAAQ,IAAI,IAAI,CAAC;QAE/C,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAClC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;gBACnE,QAAQ,GAAG,MAAM,EAAE,EAAE,IAAI,IAAI,CAAC;YAChC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,iEAAiE;gBACjE,QAAQ,GAAG,IAAI,CAAC;gBAChB,IAAI,CAAC,MAAM,EAAE,KAAK,CAChB,EAAE,GAAG,EAAE,aAAa,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,EAC7C,2CAA2C,CAC5C,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ;YAC5B,CAAC,CAAC;gBACE,OAAO,EAAE,IAAI,CAAC,QAAQ,CAAC,OAAO;gBAC9B,SAAS,EAAE,IAAI,CAAC,QAAQ,CAAC,SAAS;gBAClC,QAAQ;aACT;YACH,CAAC,CAAC,IAAI,CAAC;QAET,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,EAAE,EAAE,IAAI,IAAI,CAAC;QACtD,MAAM,cAAc,GAClB,OAAO,IAAI,CAAC,YAAY,KAAK,UAAU;YACrC,CAAC,CAAC,IAAI,CAAC,YAAY,EAAE;YACrB,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC;QACxB,MAAM,eAAe,GAAG,YAAY,EAAE,SAAS,IAAI,IAAI,CAAC;QACxD,MAAM,WAAW,GACf,YAAY,EAAE,MAAM,KAAK,WAAW,IAAI,YAAY,CAAC,QAAQ,KAAK,KAAK,CAAC;QAC1E,MAAM,SAAS,GACb,WAAW,IAAI,eAAe;YAC5B,CAAC,CAAC,eAAe;YACjB,CAAC,CAAC,CAAC,cAAc,IAAI,IAAI,CAAC,CAAC;QAC/B,MAAM,eAAe,GAAG,eAAe,IAAI,SAAS,CAAC;QACrD,MAAM,YAAY,GAChB,IAAI,CAAC,WAAW,IAAI,QAAQ,IAAI,eAAe;YAC7C,CAAC,CAAC;gBACE,YAAY,EAAE,IAAI,CAAC,WAAW;gBAC9B,aAAa,EAAE,QAAQ,CAAC,OAAO;gBAC/B,SAAS,EAAE,QAAQ,CAAC,SAAS;gBAC7B,SAAS,EAAE,eAAe;gBAC1B,QAAQ;gBACR,UAAU,EAAE,OAAO,CAAC,QAAQ,CAAC;aAC9B;YACH,CAAC,CAAC,IAAI,CAAC;QACX,MAAM,MAAM,GACV,YAAY,IAAI,YAAY,IAAI,YAAY,CAAC,SAAS;YACpD,CAAC,CAAC;gBACE,GAAG,YAAY;gBACf,QAAQ,EACN,YAAY,CAAC,UAAU,IAAI,YAAY,CAAC,QAAQ,KAAK,KAAK;gBAC5D,OAAO,EAAE,YAAY,CAAC,UAAU;oBAC9B,CAAC,CAAC,YAAY,CAAC,OAAO;oBACtB,CAAC,CAAC,oCAAoC;aACzC;YACH,CAAC,CAAC,YAAY,CAAC;QACnB,MAAM,gBAAgB,GACpB,CAAC,MAAM,IAAI,CAAC,mBAAmB,EAAE,WAAW,EAAE,CAAC,IAAI,IAAI,CAAC;QAE1D,OAAO,CAAC,CAAC,IAAI,CAAC;YACZ,MAAM,EAAE,gBAAgB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,aAAa;YACpD,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,IAAI,CAAC;YACnC,KAAK,EAAE,IAAI,CAAC,WAAW,IAAI,IAAI;YAC/B,SAAS;YACT,UAAU,EAAE,IAAI,CAAC,aAAa,EAAE,GAAG,IAAI,IAAI;YAC3C,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,IAAI;YACzC,QAAQ;YACR,YAAY;YACZ,MAAM;YACN,OAAO,EAAE;gBACP,IAAI,EAAE,SAAS;gBACf,SAAS,EAAE,gBAAgB;aAC5B;SACF,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IAEH,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/routes/mcp.d.ts

@@ -1,10 +1,97 @@
+/**
+ * MCP routes — both the Claude-facing `/mcp/:token` Streamable HTTP endpoint
+ * and the owner-only `/v1/mcp/connections` management surface.
+ *
+ * §1–§3 of `260604-PLAN-vana-mcp-personal-server.md`.
+ *
+ * Owner endpoints reuse `createServerApiAuth().authorizeOwner` so the same
+ * auth surface that gates `/v1/grants` gates connection management. The
+ * Claude-facing endpoint uses the connection token as a capability — there
+ * is no Web3Signed payload from Claude; the token resolves to a connection
+ * and we then sign reads ourselves with the per-connection grantee.
+ *
+ * NOTE on Phase-1 storage: this route accepts an `McpConnectionStore` from
+ * the caller. The in-memory implementation in `core/src/mcp/store.ts` is
+ * fine for tests and the first server-side smoke; for Web PS Lite an
+ * IndexedDB-backed adapter is the natural production path (Phase-2 §4
+ * "encrypt grantee private keys at rest" applies there).
+ */
 import { Hono } from "hono";
-import type { McpContext } from "@opendatalabs/personal-server-ts-mcp";
-import type { OAuthProvider } from "../oauth/provider.js";
+import type { Logger } from "pino";
+import type { DataPortabilityGatewayConfig, GatewayClient } from "@opendatalabs/vana-sdk/node";
+import { buildMcpUrl, buildStableMcpUrl, type McpConnectionStore, type McpOAuthAuthorizationStore, type McpActivityRecorder } from "@opendatalabs/personal-server-ts-core/mcp";
+import type { PersonalServerReadFulfillmentReporter } from "@opendatalabs/personal-server-ts-core/api";
+import type { AccessLogWriter } from "@opendatalabs/personal-server-ts-core/logging/access-log";
+import type { ServerSigner } from "@opendatalabs/personal-server-ts-core/signing";
+import type { HierarchyManagerOptions } from "@opendatalabs/personal-server-ts-core/storage/hierarchy";
+import type { IndexManager } from "@opendatalabs/personal-server-ts-core/storage/index";
+import type { DataStoragePort, RuntimeAvailabilityPort } from "@opendatalabs/personal-server-ts-core/ports";
+import type { TokenStore } from "../token-store.js";
 export interface McpRouteDeps {
-    mcpContext: McpContext;
-    oauthProvider?: OAuthProvider;
-    serverOrigin?: string | (() => string);
+    logger: Logger;
+    /**
+     * `serverOrigin` used both as the Web3Signed `aud` for the per-connection
+     * grantee's self-issued read requests AND as the base URL printed back to
+     * the user when they create a connection ("paste this into Claude").
+     * Caller may pass a thunk if the public origin depends on relay state.
+     */
+    serverOrigin: string | (() => string);
+    serverOwner?: `0x${string}`;
+    serverSigner?: Pick<ServerSigner, "signGrantRegistration">;
+    gateway: GatewayClient;
+    gatewayConfig?: (DataPortabilityGatewayConfig & {
+        url?: string;
+    }) | null;
+    devToken?: string;
+    accessToken?: string;
+    tokenStore?: TokenStore;
+    accessLogWriter: AccessLogWriter;
+    readFulfillmentReporter?: PersonalServerReadFulfillmentReporter;
+    indexManager?: IndexManager;
+    hierarchyOptions?: HierarchyManagerOptions;
+    dataStorage?: DataStoragePort;
+    runtimeAvailability?: RuntimeAvailabilityPort;
+    /** Per-process connection store. Defaults to in-memory. */
+    connectionStore?: McpConnectionStore;
+    /**
+     * OAuth authorization store shared by `/mcp/oauth/authorize`,
+     * `/mcp/oauth/token`, and the owner approval endpoint.
+     */
+    oauthAuthorizationStore?: McpOAuthAuthorizationStore;
+    /** Activity recorder for live MCP call visibility. */
+    activityRecorder?: McpActivityRecorder;
+    /**
+     * Vana Web approval surface. `/mcp/oauth/authorize` redirects owners here
+     * with `mcp_authorization` and `ps_origin` query params.
+     */
+    oauthApprovalUrl?: string | (() => string);
 }
-export declare function mcpRoute(deps: McpRouteDeps): Hono;
+/**
+ * Hono sub-app for the owner-only `/v1/mcp/connections` endpoints.
+ * Mount under `/v1/mcp/connections` in `app.ts`.
+ */
+export declare function mcpConnectionsRoutes(deps: McpRouteDeps): Hono;
+/**
+ * Top-level MCP OAuth/discovery routes.
+ *
+ * Mount at `/` so the well-known documents are served from the PS origin and
+ * Claude can discover auth for the stable `/mcp` resource.
+ */
+export declare function mcpOAuthRoutes(deps: McpRouteDeps): Hono;
+/**
+ * Hono sub-app for the Claude-facing Streamable HTTP endpoint.
+ * Mount under `/mcp` in `app.ts`; stable `/mcp` accepts OAuth bearer tokens
+ * and legacy `/mcp/:connectionToken` still accepts token-in-path calls.
+ *
+ * NOTE: this MUST receive the SAME `connectionStore` instance you pass to
+ * `mcpConnectionsRoutes` — otherwise the management API creates connections
+ * that the Claude endpoint can never see.
+ */
+export declare function mcpStreamableHttpRoutes(deps: McpRouteDeps): Hono;
+/**
+ * Owner-only activity feed route. Mount at `/v1/mcp/activity` in `app.ts`.
+ * Returns the current snapshot from the shared `McpActivityRecorder`.
+ */
+export declare function mcpActivityRoutes(deps: McpRouteDeps): Hono;
+export { buildMcpUrl, buildStableMcpUrl };
 //# sourceMappingURL=mcp.d.ts.map

package/dist/routes/mcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/routes/mcp.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAG5B,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,WAAW,YAAY;IAC3B,UAAU,EAAE,UAAU,CAAC;IACvB,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,YAAY,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;CACxC;AAED,wBAAgB,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAsEjD"}
+{"version":3,"file":"mcp.d.ts","sourceRoot":"","sources":["../../src/routes/mcp.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE5B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AACnC,OAAO,KAAK,EACV,4BAA4B,EAC5B,aAAa,EACd,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAKL,WAAW,EACX,iBAAiB,EAkBjB,KAAK,kBAAkB,EACvB,KAAK,0BAA0B,EAC/B,KAAK,mBAAmB,EACzB,MAAM,2CAA2C,CAAC;AACnD,OAAO,KAAK,EAGV,qCAAqC,EACtC,MAAM,2CAA2C,CAAC;AAGnD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,0DAA0D,CAAC;AAChG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+CAA+C,CAAC;AAClF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,yDAAyD,CAAC;AACvG,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qDAAqD,CAAC;AACxF,OAAO,KAAK,EACV,eAAe,EACf,uBAAuB,EACxB,MAAM,6CAA6C,CAAC;AACrD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGpD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf;;;;;OAKG;IACH,YAAY,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;IACtC,WAAW,CAAC,EAAE,KAAK,MAAM,EAAE,CAAC;IAC5B,YAAY,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,uBAAuB,CAAC,CAAC;IAC3D,OAAO,EAAE,aAAa,CAAC;IACvB,aAAa,CAAC,EAAE,CAAC,4BAA4B,GAAG;QAAE,GAAG,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,GAAG,IAAI,CAAC;IACzE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,UAAU,CAAC;IACxB,eAAe,EAAE,eAAe,CAAC;IACjC,uBAAuB,CAAC,EAAE,qCAAqC,CAAC;IAChE,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,gBAAgB,CAAC,EAAE,uBAAuB,CAAC;IAC3C,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,mBAAmB,CAAC,EAAE,uBAAuB,CAAC;IAC9C,2DAA2D;IAC3D,eAAe,CAAC,EAAE,kBAAkB,CAAC;IACrC;;;OAGG;IACH,uBAAuB,CAAC,EAAE,0BAA0B,CAAC;IACrD,sDAAsD;IACtD,gBAAgB,CAAC,EAAE,mBAAmB,CAAC;IACvC;;;OAGG;IACH,gBAAgB,CAAC,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,CAAC,CAAC;CAC5C;AAqID;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAqG7D;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAgTvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAoFhE;AAED;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,YAAY,GAAG,IAAI,CAkC1D;AAED,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,CAAC"}