@opendatalabs/personal-server-ts-core 0.0.1-canary.00328bf

package/dist/mcp/resources.js

@@ -0,0 +1,114 @@
+import { z } from "zod";
+import { McpDataReadError } from "./read-client.js";
+export const RAW_SCOPE_RESOURCE_TEMPLATES = [
+    "vana://scope/{scope}/raw",
+    "vana://scope/{scope}/raw/at/{at}",
+    "vana://scope/{scope}/raw/file/{fileId}",
+];
+export function rawScopeResourceUri(params) {
+    const scope = encodeURIComponent(params.scope);
+    if (params.fileId) {
+        return `vana://scope/${scope}/raw/file/${encodeURIComponent(params.fileId)}`;
+    }
+    if (params.at) {
+        return `vana://scope/${scope}/raw/at/${encodeURIComponent(params.at)}`;
+    }
+    return `vana://scope/${scope}/raw`;
+}
+export function parseRawScopeResourceUri(uri) {
+    if (uri.protocol !== "vana:" || uri.hostname !== "scope") {
+        throw new Error("Invalid raw scope resource URI");
+    }
+    const parts = uri.pathname.split("/").filter(Boolean);
+    if (parts.length < 2 || parts[1] !== "raw") {
+        throw new Error("Invalid raw scope resource URI");
+    }
+    if (parts.length === 4 && parts[2] === "at") {
+        return {
+            scope: decodeURIComponent(parts[0] ?? ""),
+            at: decodeURIComponent(parts[3] ?? ""),
+        };
+    }
+    if (parts.length === 4 && parts[2] === "file") {
+        return {
+            scope: decodeURIComponent(parts[0] ?? ""),
+            fileId: decodeURIComponent(parts[3] ?? ""),
+        };
+    }
+    if (parts.length !== 2) {
+        throw new Error("Invalid raw scope resource URI");
+    }
+    return {
+        scope: decodeURIComponent(parts[0] ?? ""),
+    };
+}
+export function resolveGrantForRawScopeResource(connection, scope) {
+    for (const grant of connection.grants) {
+        for (const granted of grant.scopes) {
+            if (granted === scope || granted === "*") {
+                return { grantId: grant.grantId };
+            }
+            if (granted.endsWith(".*")) {
+                const prefix = granted.slice(0, -2);
+                if (scope.startsWith(`${prefix}.`)) {
+                    return { grantId: grant.grantId };
+                }
+            }
+        }
+    }
+    return null;
+}
+export async function readRawScopeResource(uri, ctx) {
+    const params = parseRawScopeResourceUri(uri);
+    const grant = resolveGrantForRawScopeResource(ctx.connection, params.scope);
+    if (!grant) {
+        throw new McpDataReadError(403, {
+            error: "scope_not_granted",
+            message: `Scope '${params.scope}' is not covered by this MCP connection.`,
+        });
+    }
+    const raw = await ctx.readClient.readRawScopeFile({
+        scope: params.scope,
+        grantId: grant.grantId,
+        at: params.at,
+        fileId: params.fileId,
+    });
+    return {
+        contents: [
+            {
+                uri: uri.toString(),
+                mimeType: raw.mimeType,
+                blob: raw.contentBase64,
+                _meta: rawScopeMetadata(raw),
+            },
+        ],
+    };
+}
+export function rawScopeMetadata(raw) {
+    return {
+        scope: raw.scope,
+        ...(raw.collectedAt ? { collectedAt: raw.collectedAt } : {}),
+        ...(raw.fileId ? { fileId: raw.fileId } : {}),
+        ...(raw.filename ? { filename: raw.filename } : {}),
+        mimeType: raw.mimeType,
+        sizeBytes: raw.sizeBytes,
+        ...(raw.metadata !== undefined ? { metadata: raw.metadata } : {}),
+    };
+}
+export const rawScopeFileInputSchema = {
+    scope: z.string().min(1).describe("Exact approved file scope."),
+    at: z.string().min(1).optional(),
+    fileId: z.string().min(1).optional(),
+    includeContent: z
+        .boolean()
+        .optional()
+        .describe("Embed bytes as an MCP resource blob. Defaults to false; resource links are safer for broad client compatibility."),
+    maxBytes: z
+        .number()
+        .int()
+        .min(1)
+        .max(25 * 1024 * 1024)
+        .optional()
+        .describe("Max embedded bytes."),
+};
+//# sourceMappingURL=resources.js.map

package/dist/mcp/resources.js.map

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

package/dist/mcp/search/index.d.ts

@@ -0,0 +1,34 @@
+export interface SearchDocument {
+    id: string;
+    scope: string;
+    source?: string;
+    text: string;
+    title?: string;
+    preview?: string;
+    blockRef?: string;
+}
+export interface SearchHit extends Omit<SearchDocument, "text"> {
+    score: number;
+    terms: string[];
+}
+export interface SearchQuery {
+    query: string;
+    scopes?: readonly string[];
+    limit?: number;
+}
+export interface SearchIndex {
+    add(documents: readonly SearchDocument[]): void;
+    search(query: SearchQuery): SearchHit[];
+    serialize(): string;
+}
+export declare class MiniSearchIndex implements SearchIndex {
+    private readonly index;
+    private constructor();
+    static empty(): MiniSearchIndex;
+    static build(documents: readonly SearchDocument[]): MiniSearchIndex;
+    static load(serialized: string): MiniSearchIndex;
+    add(documents: readonly SearchDocument[]): void;
+    search({ query, scopes, limit }: SearchQuery): SearchHit[];
+    serialize(): string;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/mcp/search/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/mcp/search/index.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,SAAU,SAAQ,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC;IAC7D,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,GAAG,IAAI,CAAC;IAChD,MAAM,CAAC,KAAK,EAAE,WAAW,GAAG,SAAS,EAAE,CAAC;IACxC,SAAS,IAAI,MAAM,CAAC;CACrB;AAgID,qBAAa,eAAgB,YAAW,WAAW;IACjD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA6B;IAEnD,OAAO;IAIP,MAAM,CAAC,KAAK,IAAI,eAAe;IAI/B,MAAM,CAAC,KAAK,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,GAAG,eAAe;IAMnE,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe;IAMhD,GAAG,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,GAAG,IAAI;IAI/C,MAAM,CAAC,EAAE,KAAK,EAAE,MAAM,EAAE,KAAU,EAAE,EAAE,WAAW,GAAG,SAAS,EAAE;IAc/D,SAAS,IAAI,MAAM;CAGpB"}

package/dist/mcp/search/index.js

@@ -0,0 +1,156 @@
+import MiniSearch from "minisearch";
+const SEARCH_FIELDS = ["title", "text", "preview"];
+const STORE_FIELDS = ["id", "scope", "source", "title", "preview", "blockRef"];
+/**
+ * Terms shorter than this are indexed but never prefix-expanded: with
+ * `prefix: true` on every term a two-letter query expands to "starts with those
+ * two letters", which matches essentially every document and turns search into
+ * "return whatever came first".
+ */
+const PREFIX_MIN_TERM_CHARS = 4;
+/** Single characters carry no signal and match nearly everything. */
+const MIN_TERM_CHARS = 2;
+/**
+ * MiniSearch ships no stopword list, so an ordinary question ("what did I say
+ * about the kiln") matches every document containing "the". Dropping function
+ * words at index AND query time is what makes the remaining scores meaningful.
+ */
+const STOPWORDS = new Set([
+    "a",
+    "an",
+    "and",
+    "are",
+    "as",
+    "at",
+    "be",
+    "but",
+    "by",
+    "did",
+    "do",
+    "does",
+    "for",
+    "from",
+    "had",
+    "has",
+    "have",
+    "he",
+    "how",
+    "i",
+    "if",
+    "in",
+    "is",
+    "it",
+    "its",
+    "me",
+    "my",
+    "no",
+    "not",
+    "of",
+    "on",
+    "or",
+    "our",
+    "she",
+    "so",
+    "that",
+    "the",
+    "their",
+    "them",
+    "then",
+    "there",
+    "they",
+    "this",
+    "to",
+    "was",
+    "we",
+    "were",
+    "what",
+    "when",
+    "where",
+    "which",
+    "who",
+    "why",
+    "will",
+    "with",
+    "you",
+    "your",
+]);
+/**
+ * Relevance floor, expressed as a fraction of the best hit for the same query.
+ * BM25 scores are corpus-relative, so an absolute floor would be meaningless
+ * across scopes of wildly different size; a relative floor reliably drops the
+ * tail of documents that merely share one weak term with the query.
+ */
+const SCORE_FLOOR_RATIO = 0.25;
+function processTerm(term) {
+    const normalized = term.toLowerCase();
+    if (normalized.length < MIN_TERM_CHARS)
+        return null;
+    return STOPWORDS.has(normalized) ? null : normalized;
+}
+/**
+ * Single source of truth for index + query behaviour. `load()` MUST be given
+ * the same options the index was built with, otherwise a deserialized index
+ * tokenizes queries differently from the documents it holds.
+ */
+const MINISEARCH_OPTIONS = {
+    idField: "id",
+    fields: SEARCH_FIELDS,
+    storeFields: STORE_FIELDS,
+    processTerm,
+    searchOptions: {
+        boost: { title: 2, preview: 1.2, text: 1 },
+        prefix: (term) => term.length >= PREFIX_MIN_TERM_CHARS,
+    },
+};
+function createMiniSearch() {
+    return new MiniSearch(MINISEARCH_OPTIONS);
+}
+function toHit(result) {
+    return {
+        id: String(result.id),
+        scope: String(result.scope),
+        source: typeof result.source === "string" ? result.source : undefined,
+        title: typeof result.title === "string" ? result.title : undefined,
+        preview: typeof result.preview === "string" ? result.preview : undefined,
+        blockRef: typeof result.blockRef === "string" ? result.blockRef : undefined,
+        score: result.score,
+        terms: result.terms,
+    };
+}
+export class MiniSearchIndex {
+    index;
+    constructor(index) {
+        this.index = index;
+    }
+    static empty() {
+        return new MiniSearchIndex(createMiniSearch());
+    }
+    static build(documents) {
+        const index = MiniSearchIndex.empty();
+        index.add(documents);
+        return index;
+    }
+    static load(serialized) {
+        return new MiniSearchIndex(MiniSearch.loadJSON(serialized, MINISEARCH_OPTIONS));
+    }
+    add(documents) {
+        this.index.addAll(documents);
+    }
+    search({ query, scopes, limit = 20 }) {
+        const allowedScopes = scopes ? new Set(scopes) : null;
+        const results = this.index.search(query, {
+            filter: allowedScopes
+                ? (result) => allowedScopes.has(String(result.scope))
+                : undefined,
+        });
+        const scoreFloor = (results[0]?.score ?? 0) * SCORE_FLOOR_RATIO;
+        return results
+            .filter((result) => result.score >= scoreFloor)
+            .slice(0, limit)
+            .map(toHit);
+    }
+    serialize() {
+        return JSON.stringify(this.index);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/mcp/search/index.js.map

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

package/dist/mcp/server.d.ts

@@ -0,0 +1,72 @@
+/**
+ * MCP Streamable-HTTP server adapter. Per-request, stateless.
+ *
+ * Pattern adopted from `@pdpp/mcp-server`'s `handleStreamableHttpRequest`:
+ * a fresh `McpServer` + `WebStandardStreamableHTTPServerTransport` per
+ * inbound request. This keeps authorization checks fresh — the route
+ * resolves the connection token, hands us the `McpConnectionRecord`, and we
+ * build the server bound to that connection. There is NO MCP session.
+ *
+ * The transport supports Streamable HTTP (GET=SSE, POST=JSON-RPC,
+ * DELETE=close). Claude Web's remote connector speaks this.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { McpConnectionRecord } from "./types.js";
+import type { McpDataReadClient } from "./read-client.js";
+import { type McpToolContext } from "./tools.js";
+import { type PersonalServerReadReporterDeps } from "../api/index.js";
+import type { McpActivityRecorder, McpActivityStatus } from "./activity.js";
+export interface HandleMcpRequestOptions {
+    connection: McpConnectionRecord;
+    readClient: McpDataReadClient;
+    activityRecorder?: McpActivityRecorder;
+    requestScopeAccess?: McpToolContext["requestScopeAccess"];
+    /** Emits one access record per denied data tool call; see reportToolDenial. */
+    reporterDeps?: PersonalServerReadReporterDeps;
+    serverName?: string;
+    serverVersion?: string;
+}
+interface ActivityPayloadMetrics {
+    payloadBytes: number;
+    textBytes: number;
+    structuredContentBytes?: number;
+}
+interface PendingActivityFinish extends ActivityPayloadMetrics {
+    status: Exclude<McpActivityStatus, "running">;
+    handlerDurationMs: number;
+    resultCount?: number;
+    skippedCount?: number;
+    errorCode?: string;
+    errorMessage?: string;
+}
+/**
+ * Build a fresh `McpServer` instance bound to a single connection + read
+ * client. Tools delegate to `MCP_TOOLS` so the surface stays in one place.
+ */
+export declare function createMcpServerForConnection(options: HandleMcpRequestOptions): {
+    server: McpServer;
+    finishPendingActivities(override?: Pick<PendingActivityFinish, "status" | "errorCode" | "errorMessage">): void;
+};
+/**
+ * Process one inbound MCP request (GET/POST/DELETE) end-to-end. Per-request
+ * server + transport; stateless; no MCP session id retained.
+ *
+ * Returns a Web `Response` suitable to send back to the client.
+ */
+export declare function handleMcpStreamableHttpRequest(request: Request, options: HandleMcpRequestOptions): Promise<Response>;
+/**
+ * True when every JSON-RPC message in `body` is one this file can answer
+ * without the owner's data — see `HANDSHAKE_METHODS`. A batch qualifies only
+ * as a whole, so a tool call travelling with a handshake still reaches the
+ * owner's server.
+ */
+export declare function isMcpHandshake(body: unknown): boolean;
+/**
+ * Answer a handshake request from the static tool table. Same server identity,
+ * same registered surface and same transport as the full engine, so the bytes
+ * match what a dispatched call returns; the tool handlers are unreachable
+ * because no handshake method invokes one.
+ */
+export declare function handleMcpHandshake(request: Request): Promise<Response>;
+export {};
+//# sourceMappingURL=server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EACL,SAAS,EAEV,MAAM,yCAAyC,CAAC;AAEjD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAIL,KAAK,cAAc,EAEpB,MAAM,YAAY,CAAC;AACpB,OAAO,EAGL,KAAK,8BAA8B,EACpC,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAM5E,MAAM,WAAW,uBAAuB;IACtC,UAAU,EAAE,mBAAmB,CAAC;IAChC,UAAU,EAAE,iBAAiB,CAAC;IAC9B,gBAAgB,CAAC,EAAE,mBAAmB,CAAC;IACvC,kBAAkB,CAAC,EAAE,cAAc,CAAC,oBAAoB,CAAC,CAAC;IAC1D,+EAA+E;IAC/E,YAAY,CAAC,EAAE,8BAA8B,CAAC;IAC9C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAuQD,UAAU,sBAAsB;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,UAAU,qBAAsB,SAAQ,sBAAsB;IAC5D,MAAM,EAAE,OAAO,CAAC,iBAAiB,EAAE,SAAS,CAAC,CAAC;IAC9C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAwED;;;GAGG;AACH,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,uBAAuB,GAC/B;IACD,MAAM,EAAE,SAAS,CAAC;IAClB,uBAAuB,CACrB,QAAQ,CAAC,EAAE,IAAI,CACb,qBAAqB,EACrB,QAAQ,GAAG,WAAW,GAAG,cAAc,CACxC,GACA,IAAI,CAAC;CACT,CAqHA;AAED;;;;;GAKG;AACH,wBAAsB,8BAA8B,CAClD,OAAO,EAAE,OAAO,EAChB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,QAAQ,CAAC,CAsBnB;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAarD;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CA6B5E"}