@undefineds.co/xpod 0.1.0-local.202602081751

package/dist/api/models/namespaces.d.ts

@@ -0,0 +1,9 @@
+type NamespaceObject = ((term: string) => string) & {
+    prefix: string;
+    uri: string;
+    NAMESPACE: string;
+    term: (name: string) => string;
+} & Record<string, string>;
+export declare const DCTerms: NamespaceObject;
+export declare const LINQ: NamespaceObject;
+export {};

package/dist/api/models/namespaces.js

@@ -0,0 +1,34 @@
+"use strict";
+// Copied from linx/packages/models/src/namespaces.ts
+// TODO: Centralize this in a shared package (@udfs/vocab or @linx/models)
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LINQ = exports.DCTerms = void 0;
+const ABSOLUTE_IRI = /^[a-zA-Z][a-zA-Z\d+.-]*:/;
+const createNamespace = (prefix, baseUri, terms) => {
+    const builder = ((term) => ABSOLUTE_IRI.test(term) ? term : `${baseUri}${term}`);
+    builder.prefix = prefix;
+    builder.uri = baseUri;
+    builder.NAMESPACE = baseUri;
+    builder.term = (name) => builder(name);
+    Object.entries(terms).forEach(([key, local]) => {
+        Object.defineProperty(builder, key, {
+            value: builder(local),
+            enumerable: true,
+        });
+    });
+    return builder;
+};
+exports.DCTerms = createNamespace('dc', 'http://purl.org/dc/terms/', {
+    modified: 'modified',
+    created: 'created',
+});
+exports.LINQ = createNamespace('linx', 'https://linx.ai/ns#', {
+    provider: 'provider',
+    status: 'status',
+    apiKey: 'apiKey',
+    baseUrl: 'baseUrl',
+    proxy: 'proxy',
+    aiModels: 'aiModels',
+    ModelProvider: 'ModelProvider',
+});
+//# sourceMappingURL=namespaces.js.map

package/dist/api/models/namespaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"namespaces.js","sourceRoot":"","sources":["../../../src/api/models/namespaces.ts"],"names":[],"mappings":";AAAA,qDAAqD;AACrD,0EAA0E;;;AAS1E,MAAM,YAAY,GAAG,0BAA0B,CAAA;AAE/C,MAAM,eAAe,GAAG,CAAC,MAAc,EAAE,OAAe,EAAE,KAA6B,EAAmB,EAAE;IAC1G,MAAM,OAAO,GAAG,CAAC,CAAC,IAAY,EAAE,EAAE,CAChC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,OAAO,GAAG,IAAI,EAAE,CAAoB,CAAA;IAC1E,OAAO,CAAC,MAAM,GAAG,MAAM,CAAA;IACvB,OAAO,CAAC,GAAG,GAAG,OAAO,CAAA;IACrB,OAAO,CAAC,SAAS,GAAG,OAAO,CAAA;IAC3B,OAAO,CAAC,IAAI,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9C,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,EAAE,EAAE;QAC7C,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,GAAG,EAAE;YAClC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC;YACrB,UAAU,EAAE,IAAI;SACjB,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;IACF,OAAO,OAAO,CAAA;AAChB,CAAC,CAAA;AAEY,QAAA,OAAO,GAAG,eAAe,CAAC,IAAI,EAAE,2BAA2B,EAAE;IACxE,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;CACnB,CAAC,CAAA;AAEW,QAAA,IAAI,GAAG,eAAe,CAAC,MAAM,EAAE,qBAAqB,EAAE;IACjE,QAAQ,EAAE,UAAU;IACpB,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,KAAK,EAAE,OAAO;IACd,QAAQ,EAAE,UAAU;IACpB,aAAa,EAAE,eAAe;CAC/B,CAAC,CAAA","sourcesContent":["// Copied from linx/packages/models/src/namespaces.ts\n// TODO: Centralize this in a shared package (@udfs/vocab or @linx/models)\n\ntype NamespaceObject = ((term: string) => string) & {\n  prefix: string\n  uri: string\n  NAMESPACE: string\n  term: (name: string) => string\n} & Record<string, string>\n\nconst ABSOLUTE_IRI = /^[a-zA-Z][a-zA-Z\\d+.-]*:/\n\nconst createNamespace = (prefix: string, baseUri: string, terms: Record<string, string>): NamespaceObject => {\n  const builder = ((term: string) =>\n    ABSOLUTE_IRI.test(term) ? term : `${baseUri}${term}`) as NamespaceObject\n  builder.prefix = prefix\n  builder.uri = baseUri\n  builder.NAMESPACE = baseUri\n  builder.term = (name: string) => builder(name)\n  Object.entries(terms).forEach(([key, local]) => {\n    Object.defineProperty(builder, key, {\n      value: builder(local),\n      enumerable: true,\n    })\n  })\n  return builder\n}\n\nexport const DCTerms = createNamespace('dc', 'http://purl.org/dc/terms/', {\n  modified: 'modified',\n  created: 'created',\n})\n\nexport const LINQ = createNamespace('linx', 'https://linx.ai/ns#', {\n  provider: 'provider',\n  status: 'status',\n  apiKey: 'apiKey',\n  baseUrl: 'baseUrl',\n  proxy: 'proxy',\n  aiModels: 'aiModels',\n  ModelProvider: 'ModelProvider',\n})\n"]}

package/dist/api/service/InternalPodService.d.ts

@@ -0,0 +1,19 @@
+import type { ClientCredentialsStore } from '../auth/ClientCredentialsAuthenticator';
+import { type AuthContext } from '../auth/AuthContext';
+export interface InternalPodServiceOptions {
+    tokenEndpoint: string;
+    apiKeyStore: ClientCredentialsStore;
+}
+/**
+ * Service for accessing user Pod data from the backend.
+ * Dynamically logs in using the caller's API Key (Client Credentials).
+ */
+export declare class InternalPodService {
+    private readonly options;
+    private readonly logger;
+    constructor(options: InternalPodServiceOptions);
+    /**
+     * Retrieves AI model provider configuration from a user's Pod
+     */
+    getAiConfig(webId: string, auth: AuthContext): Promise<any>;
+}

package/dist/api/service/InternalPodService.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InternalPodService = void 0;
+const solid_client_authn_node_1 = require("@inrupt/solid-client-authn-node");
+const drizzle_solid_1 = require("drizzle-solid");
+const global_logger_factory_1 = require("global-logger-factory");
+const model_provider_schema_1 = require("../models/model-provider.schema");
+const AuthContext_1 = require("../auth/AuthContext");
+/**
+ * Service for accessing user Pod data from the backend.
+ * Dynamically logs in using the caller's API Key (Client Credentials).
+ */
+class InternalPodService {
+    constructor(options) {
+        this.options = options;
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+    }
+    /**
+     * Retrieves AI model provider configuration from a user's Pod
+     */
+    async getAiConfig(webId, auth) {
+        let fetcher;
+        if ((0, AuthContext_1.isSolidAuth)(auth) && auth.clientId) {
+            // API Key Mode: The caller provided a Client ID.
+            // We look up the secret and create a session for THIS client.
+            this.logger.debug(`Resolving session for client ${auth.clientId} to access ${webId}`);
+            const creds = await this.options.apiKeyStore.findByClientId(auth.clientId);
+            if (!creds) {
+                this.logger.warn(`No credentials found for client ${auth.clientId}`);
+                return undefined;
+            }
+            // Create a fresh session for this request/client
+            // TODO: Consider caching sessions to avoid login round-trip on every request
+            const session = new solid_client_authn_node_1.Session();
+            try {
+                await session.login({
+                    oidcIssuer: new URL(this.options.tokenEndpoint).origin,
+                    clientId: creds.clientId,
+                    clientSecret: creds.clientSecret,
+                });
+                if (!session.info.isLoggedIn) {
+                    throw new Error('Login returned false');
+                }
+                fetcher = session.fetch;
+            }
+            catch (error) {
+                this.logger.error(`Failed to login as client ${auth.clientId}: ${error}`);
+                return undefined;
+            }
+        }
+        else {
+            // Solid Token Mode: We cannot reuse the DPoP token for a different URL.
+            // For now, we return undefined, falling back to system defaults.
+            this.logger.debug('Solid Token auth detected; skipping Pod config fetch (DPoP limitation).');
+            return undefined;
+        }
+        // Use drizzle-solid with our authenticated session
+        const db = (0, drizzle_solid_1.drizzle)({ fetch: fetcher, info: { webId, isLoggedIn: true } });
+        try {
+            const providers = await db.select()
+                .from(model_provider_schema_1.modelProviderTable)
+                .where((0, drizzle_solid_1.eq)(model_provider_schema_1.modelProviderTable.enabled, true)); // Cast to any to bypass TS error
+            console.log(`[InternalPodService] Found ${providers.length} enabled providers:`, providers.map(p => ({ id: p.id, proxy: p.proxy, baseUrl: p.baseUrl })));
+            if (providers.length === 0) {
+                return undefined;
+            }
+            // Prefer provider with proxy configured (for external APIs like Google)
+            const withProxy = providers.find(p => p.proxy);
+            if (withProxy) {
+                console.log(`[InternalPodService] Using provider with proxy: ${withProxy.id}`);
+                return withProxy;
+            }
+            return providers[0];
+        }
+        catch (error) {
+            this.logger.warn(`Failed to read AI config from Pod for ${webId}: ${error}`);
+            return undefined;
+        }
+    }
+}
+exports.InternalPodService = InternalPodService;
+//# sourceMappingURL=InternalPodService.js.map

package/dist/api/service/InternalPodService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"InternalPodService.js","sourceRoot":"","sources":["../../../src/api/service/InternalPodService.ts"],"names":[],"mappings":"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","sourcesContent":["import { Session } from '@inrupt/solid-client-authn-node';\nimport { drizzle, eq } from 'drizzle-solid';\nimport { getLoggerFor } from 'global-logger-factory';\nimport { modelProviderTable } from '../models/model-provider.schema';\nimport type { ClientCredentialsStore } from '../auth/ClientCredentialsAuthenticator';\nimport { isSolidAuth, type AuthContext } from '../auth/AuthContext';\n\nexport interface InternalPodServiceOptions {\n  tokenEndpoint: string;\n  apiKeyStore: ClientCredentialsStore;\n}\n\n/**\n * Service for accessing user Pod data from the backend.\n * Dynamically logs in using the caller's API Key (Client Credentials).\n */\nexport class InternalPodService {\n  private readonly logger = getLoggerFor(this);\n\n  public constructor(private readonly options: InternalPodServiceOptions) {}\n\n  /**\n   * Retrieves AI model provider configuration from a user's Pod\n   */\n  public async getAiConfig(webId: string, auth: AuthContext): Promise<any> {\n    let fetcher: typeof fetch;\n\n    if (isSolidAuth(auth) && auth.clientId) {\n      // API Key Mode: The caller provided a Client ID.\n      // We look up the secret and create a session for THIS client.\n      this.logger.debug(`Resolving session for client ${auth.clientId} to access ${webId}`);\n      \n      const creds = await this.options.apiKeyStore.findByClientId(auth.clientId);\n      if (!creds) {\n        this.logger.warn(`No credentials found for client ${auth.clientId}`);\n        return undefined;\n      }\n\n      // Create a fresh session for this request/client\n      // TODO: Consider caching sessions to avoid login round-trip on every request\n      const session = new Session();\n      try {\n        await session.login({\n          oidcIssuer: new URL(this.options.tokenEndpoint).origin,\n          clientId: creds.clientId,\n          clientSecret: creds.clientSecret,\n        });\n        \n        if (!session.info.isLoggedIn) {\n          throw new Error('Login returned false');\n        }\n        fetcher = session.fetch;\n      } catch (error) {\n        this.logger.error(`Failed to login as client ${auth.clientId}: ${error}`);\n        return undefined;\n      }\n    } else {\n      // Solid Token Mode: We cannot reuse the DPoP token for a different URL.\n      // For now, we return undefined, falling back to system defaults.\n      this.logger.debug('Solid Token auth detected; skipping Pod config fetch (DPoP limitation).');\n      return undefined;\n    }\n\n    // Use drizzle-solid with our authenticated session\n    const db = drizzle({ fetch: fetcher, info: { webId, isLoggedIn: true } } as any);\n\n    try {\n      const providers = await db.select()\n        .from(modelProviderTable)\n        .where(eq((modelProviderTable as any).enabled, true)); // Cast to any to bypass TS error\n\n      console.log(`[InternalPodService] Found ${providers.length} enabled providers:`, providers.map(p => ({ id: p.id, proxy: p.proxy, baseUrl: p.baseUrl })));\n\n      if (providers.length === 0) {\n        return undefined;\n      }\n\n      // Prefer provider with proxy configured (for external APIs like Google)\n      const withProxy = providers.find(p => p.proxy);\n      if (withProxy) {\n        console.log(`[InternalPodService] Using provider with proxy: ${withProxy.id}`);\n        return withProxy;\n      }\n\n      return providers[0];\n    } catch (error) {\n      this.logger.warn(`Failed to read AI config from Pod for ${webId}: ${error}`);\n      return undefined;\n    }\n  }\n}\n"]}

package/dist/api/service/VectorService.d.ts

@@ -0,0 +1,156 @@
+import type { PodChatKitStore } from '../chatkit/pod-store';
+import type { AuthContext } from '../auth/AuthContext';
+import type { EmbeddingService } from '../../ai/service/EmbeddingService';
+/**
+ * Vector upsert request
+ */
+export interface VectorUpsertRequest {
+    /** Embedding model name */
+    model: string;
+    /** Vectors to upsert */
+    vectors: Array<{
+        /** Resource URI */
+        subject: string;
+        /** Semantic aspect (type, chunk, property) */
+        aspect: string;
+        /** Vector data */
+        vector: number[];
+    }>;
+}
+/**
+ * Vector search request
+ */
+export interface VectorSearchRequest {
+    /** Embedding model name */
+    model: string;
+    /** Query text (will be converted to vector) */
+    query?: string;
+    /** Pre-computed query vector */
+    vector?: number[];
+    /** Max results */
+    limit?: number;
+    /** Similarity threshold (0-1) */
+    threshold?: number;
+    /** Filter conditions */
+    filter?: {
+        subject?: {
+            $eq?: string;
+            $startsWith?: string;
+            $in?: string[];
+        };
+        aspect?: {
+            $eq?: string;
+            $startsWith?: string;
+            $in?: string[];
+        };
+    };
+    /** Deduplicate by subject */
+    distinctSubject?: boolean;
+}
+/**
+ * Vector search result
+ */
+export interface VectorSearchResult {
+    subject: string;
+    aspect: string;
+    score: number;
+    distance: number;
+}
+/**
+ * Vector delete request
+ */
+export interface VectorDeleteRequest {
+    /** Embedding model name */
+    model: string;
+    /** Filter conditions (at least one field required) */
+    filter: {
+        subject?: {
+            $eq?: string;
+            $startsWith?: string;
+        };
+        aspect?: {
+            $eq?: string;
+            $startsWith?: string;
+        };
+    };
+}
+/**
+ * Vector status response
+ */
+export interface VectorStatusResponse {
+    byModel: Array<{
+        model: string;
+        count: number;
+    }>;
+    totalCount: number;
+}
+export interface VectorServiceOptions {
+    /** CSS base URL for vector API */
+    cssBaseUrl: string;
+    /** Pod store for getting AI credentials */
+    store: PodChatKitStore;
+    /** Embedding service for generating vectors */
+    embeddingService: EmbeddingService;
+}
+/**
+ * VectorService - API Server 的向量服务
+ *
+ * 负责：
+ * 1. 从 Pod 读取 AI 凭据
+ * 2. 调用 EmbeddingService 生成向量
+ * 3. 调用 CSS 的 /-/vector/* 端点存储/搜索向量
+ */
+export declare class VectorService {
+    private readonly logger;
+    private readonly cssBaseUrl;
+    private readonly store;
+    private readonly embeddingService;
+    constructor(options: VectorServiceOptions);
+    /**
+     * Upsert vectors to CSS vector store
+     */
+    upsert(request: VectorUpsertRequest, auth: AuthContext, accessToken: string): Promise<{
+        upserted: number;
+        errors: string[];
+        took_ms: number;
+    }>;
+    /**
+     * Search vectors in CSS vector store
+     */
+    search(request: VectorSearchRequest, auth: AuthContext, accessToken: string): Promise<{
+        results: VectorSearchResult[];
+        model: string;
+        took_ms: number;
+    }>;
+    /**
+     * Delete vectors from CSS vector store
+     */
+    delete(request: VectorDeleteRequest, auth: AuthContext, accessToken: string): Promise<{
+        deleted: number;
+        errors: string[];
+        took_ms: number;
+    }>;
+    /**
+     * Get vector store status
+     */
+    status(accessToken: string): Promise<VectorStatusResponse>;
+    /**
+     * Generate embedding for text
+     */
+    embed(text: string, model: string, auth: AuthContext): Promise<number[]>;
+    /**
+     * Generate embeddings for multiple texts
+     */
+    embedBatch(texts: string[], model: string, auth: AuthContext): Promise<number[][]>;
+    /**
+     * Create a StoreContext from AuthContext for Pod operations
+     */
+    private createStoreContext;
+    private getAiCredential;
+    private callCssVectorApi;
+    /**
+     * Hash subject + aspect to numeric ID
+     * Uses FNV-1a hash for good distribution
+     */
+    private hashSubjectAspect;
+}

package/dist/api/service/VectorService.js

@@ -0,0 +1,202 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VectorService = void 0;
+const global_logger_factory_1 = require("global-logger-factory");
+const AuthContext_1 = require("../auth/AuthContext");
+/**
+ * VectorService - API Server 的向量服务
+ *
+ * 负责：
+ * 1. 从 Pod 读取 AI 凭据
+ * 2. 调用 EmbeddingService 生成向量
+ * 3. 调用 CSS 的 /-/vector/* 端点存储/搜索向量
+ */
+class VectorService {
+    constructor(options) {
+        this.logger = (0, global_logger_factory_1.getLoggerFor)(this);
+        this.cssBaseUrl = options.cssBaseUrl.replace(/\/$/, '');
+        this.store = options.store;
+        this.embeddingService = options.embeddingService;
+    }
+    /**
+     * Upsert vectors to CSS vector store
+     */
+    async upsert(request, auth, accessToken) {
+        const startTime = Date.now();
+        const userId = (0, AuthContext_1.getWebId)(auth) ?? (0, AuthContext_1.getAccountId)(auth) ?? 'anonymous';
+        this.logger.info(`Vector upsert request from ${userId}, model: ${request.model}, count: ${request.vectors.length}`);
+        // Convert subject+aspect to numeric IDs using hash
+        const vectorsWithIds = request.vectors.map((v) => ({
+            id: this.hashSubjectAspect(v.subject, v.aspect),
+            vector: v.vector,
+        }));
+        // Call CSS vector API
+        const response = await this.callCssVectorApi('upsert', accessToken, {
+            model: request.model,
+            vectors: vectorsWithIds,
+        });
+        return {
+            upserted: response.upserted ?? 0,
+            errors: response.errors ?? [],
+            took_ms: Date.now() - startTime,
+        };
+    }
+    /**
+     * Search vectors in CSS vector store
+     */
+    async search(request, auth, accessToken) {
+        const startTime = Date.now();
+        const userId = (0, AuthContext_1.getWebId)(auth) ?? (0, AuthContext_1.getAccountId)(auth) ?? 'anonymous';
+        this.logger.info(`Vector search request from ${userId}, model: ${request.model}`);
+        let queryVector = request.vector;
+        // If query text provided, generate embedding
+        if (request.query && !queryVector) {
+            const credential = await this.getAiCredential(auth);
+            if (!credential) {
+                throw new Error('No AI credential found for embedding generation');
+            }
+            queryVector = await this.embeddingService.embed(request.query, credential, request.model);
+        }
+        if (!queryVector) {
+            throw new Error('Either query or vector must be provided');
+        }
+        // Call CSS vector API
+        const response = await this.callCssVectorApi('search', accessToken, {
+            model: request.model,
+            vector: queryVector,
+            limit: request.limit ?? 10,
+            threshold: request.threshold,
+            excludeIds: undefined, // TODO: implement filter to excludeIds conversion
+        });
+        // Map numeric IDs back to subject+aspect (requires metadata storage)
+        // For now, return IDs as subjects (external API Server should maintain mapping)
+        const results = (response.results ?? []).map((r) => ({
+            subject: String(r.id), // Placeholder - actual mapping should be done by caller
+            aspect: '',
+            score: r.score,
+            distance: r.distance,
+        }));
+        return {
+            results,
+            model: request.model,
+            took_ms: Date.now() - startTime,
+        };
+    }
+    /**
+     * Delete vectors from CSS vector store
+     */
+    async delete(request, auth, accessToken) {
+        const startTime = Date.now();
+        const userId = (0, AuthContext_1.getWebId)(auth) ?? (0, AuthContext_1.getAccountId)(auth) ?? 'anonymous';
+        this.logger.info(`Vector delete request from ${userId}, model: ${request.model}`);
+        // Convert filter to IDs (simplified - actual implementation needs metadata lookup)
+        const ids = [];
+        if (request.filter.subject?.$eq && request.filter.aspect?.$eq) {
+            ids.push(this.hashSubjectAspect(request.filter.subject.$eq, request.filter.aspect.$eq));
+        }
+        if (ids.length === 0) {
+            return { deleted: 0, errors: ['No matching vectors found'], took_ms: Date.now() - startTime };
+        }
+        // Call CSS vector API
+        const response = await this.callCssVectorApi('delete', accessToken, {
+            model: request.model,
+            ids,
+        });
+        return {
+            deleted: response.deleted ?? 0,
+            errors: response.errors ?? [],
+            took_ms: Date.now() - startTime,
+        };
+    }
+    /**
+     * Get vector store status
+     */
+    async status(accessToken) {
+        const response = await this.callCssVectorApi('status', accessToken, undefined, 'GET');
+        return {
+            byModel: response.byModel ?? [],
+            totalCount: response.totalCount ?? 0,
+        };
+    }
+    /**
+     * Generate embedding for text
+     */
+    async embed(text, model, auth) {
+        const credential = await this.getAiCredential(auth);
+        if (!credential) {
+            throw new Error('No AI credential found for embedding generation');
+        }
+        return this.embeddingService.embed(text, credential, model);
+    }
+    /**
+     * Generate embeddings for multiple texts
+     */
+    async embedBatch(texts, model, auth) {
+        const credential = await this.getAiCredential(auth);
+        if (!credential) {
+            throw new Error('No AI credential found for embedding generation');
+        }
+        return this.embeddingService.embedBatch(texts, credential, model);
+    }
+    // ============================================
+    // Private methods
+    // ============================================
+    /**
+     * Create a StoreContext from AuthContext for Pod operations
+     */
+    createStoreContext(auth) {
+        return {
+            userId: (0, AuthContext_1.getWebId)(auth) ?? (0, AuthContext_1.getAccountId)(auth) ?? 'anonymous',
+            auth,
+        };
+    }
+    async getAiCredential(auth) {
+        const context = this.createStoreContext(auth);
+        const config = await this.store.getAiConfig(context);
+        if (!config) {
+            return undefined;
+        }
+        return {
+            provider: config.providerId,
+            apiKey: config.apiKey,
+            baseUrl: config.baseUrl,
+            proxyUrl: config.proxyUrl,
+        };
+    }
+    async callCssVectorApi(action, accessToken, body, method = 'POST') {
+        const url = `${this.cssBaseUrl}/-/vector/${action}`;
+        const options = {
+            method,
+            headers: {
+                'Authorization': `Bearer ${accessToken}`,
+                'Content-Type': 'application/json',
+            },
+        };
+        if (body && method !== 'GET') {
+            options.body = JSON.stringify(body);
+        }
+        this.logger.debug(`Calling CSS vector API: ${method} ${url}`);
+        const response = await fetch(url, options);
+        if (!response.ok) {
+            const errorText = await response.text();
+            this.logger.error(`CSS vector API error: ${response.status} ${errorText}`);
+            throw new Error(`CSS vector API error: ${response.status} ${response.statusText}`);
+        }
+        return response.json();
+    }
+    /**
+     * Hash subject + aspect to numeric ID
+     * Uses FNV-1a hash for good distribution
+     */
+    hashSubjectAspect(subject, aspect) {
+        const str = `${subject}|${aspect}`;
+        let hash = 2166136261; // FNV offset basis
+        for (let i = 0; i < str.length; i++) {
+            hash ^= str.charCodeAt(i);
+            hash = Math.imul(hash, 16777619); // FNV prime
+        }
+        return Math.abs(hash);
+    }
+}
+exports.VectorService = VectorService;
+//# sourceMappingURL=VectorService.js.map

package/dist/api/service/VectorService.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"VectorService.js","sourceRoot":"","sources":["../../../src/api/service/VectorService.ts"],"names":[],"mappings":"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","sourcesContent":["import { getLoggerFor } from 'global-logger-factory';\nimport type { PodChatKitStore } from '../chatkit/pod-store';\nimport type { StoreContext } from '../chatkit/store';\nimport type { AuthContext } from '../auth/AuthContext';\nimport { getWebId, getAccountId } from '../auth/AuthContext';\nimport type { EmbeddingService } from '../../ai/service/EmbeddingService';\nimport type { AiCredential } from '../../ai/service/types';\n\n/**\n * Vector upsert request\n */\nexport interface VectorUpsertRequest {\n  /** Embedding model name */\n  model: string;\n  /** Vectors to upsert */\n  vectors: Array<{\n    /** Resource URI */\n    subject: string;\n    /** Semantic aspect (type, chunk, property) */\n    aspect: string;\n    /** Vector data */\n    vector: number[];\n  }>;\n}\n\n/**\n * Vector search request\n */\nexport interface VectorSearchRequest {\n  /** Embedding model name */\n  model: string;\n  /** Query text (will be converted to vector) */\n  query?: string;\n  /** Pre-computed query vector */\n  vector?: number[];\n  /** Max results */\n  limit?: number;\n  /** Similarity threshold (0-1) */\n  threshold?: number;\n  /** Filter conditions */\n  filter?: {\n    subject?: { $eq?: string; $startsWith?: string; $in?: string[] };\n    aspect?: { $eq?: string; $startsWith?: string; $in?: string[] };\n  };\n  /** Deduplicate by subject */\n  distinctSubject?: boolean;\n}\n\n/**\n * Vector search result\n */\nexport interface VectorSearchResult {\n  subject: string;\n  aspect: string;\n  score: number;\n  distance: number;\n}\n\n/**\n * Vector delete request\n */\nexport interface VectorDeleteRequest {\n  /** Embedding model name */\n  model: string;\n  /** Filter conditions (at least one field required) */\n  filter: {\n    subject?: { $eq?: string; $startsWith?: string };\n    aspect?: { $eq?: string; $startsWith?: string };\n  };\n}\n\n/**\n * Vector status response\n */\nexport interface VectorStatusResponse {\n  byModel: Array<{ model: string; count: number }>;\n  totalCount: number;\n}\n\nexport interface VectorServiceOptions {\n  /** CSS base URL for vector API */\n  cssBaseUrl: string;\n  /** Pod store for getting AI credentials */\n  store: PodChatKitStore;\n  /** Embedding service for generating vectors */\n  embeddingService: EmbeddingService;\n}\n\n/**\n * VectorService - API Server 的向量服务\n *\n * 负责：\n * 1. 从 Pod 读取 AI 凭据\n * 2. 调用 EmbeddingService 生成向量\n * 3. 调用 CSS 的 /-/vector/* 端点存储/搜索向量\n */\nexport class VectorService {\n  private readonly logger = getLoggerFor(this);\n  private readonly cssBaseUrl: string;\n  private readonly store: PodChatKitStore;\n  private readonly embeddingService: EmbeddingService;\n\n  public constructor(options: VectorServiceOptions) {\n    this.cssBaseUrl = options.cssBaseUrl.replace(/\\/$/, '');\n    this.store = options.store;\n    this.embeddingService = options.embeddingService;\n  }\n\n  /**\n   * Upsert vectors to CSS vector store\n   */\n  public async upsert(\n    request: VectorUpsertRequest,\n    auth: AuthContext,\n    accessToken: string,\n  ): Promise<{ upserted: number; errors: string[]; took_ms: number }> {\n    const startTime = Date.now();\n    const userId = getWebId(auth) ?? getAccountId(auth) ?? 'anonymous';\n\n    this.logger.info(`Vector upsert request from ${userId}, model: ${request.model}, count: ${request.vectors.length}`);\n\n    // Convert subject+aspect to numeric IDs using hash\n    const vectorsWithIds = request.vectors.map((v) => ({\n      id: this.hashSubjectAspect(v.subject, v.aspect),\n      vector: v.vector,\n    }));\n\n    // Call CSS vector API\n    const response = await this.callCssVectorApi('upsert', accessToken, {\n      model: request.model,\n      vectors: vectorsWithIds,\n    });\n\n    return {\n      upserted: response.upserted ?? 0,\n      errors: response.errors ?? [],\n      took_ms: Date.now() - startTime,\n    };\n  }\n\n  /**\n   * Search vectors in CSS vector store\n   */\n  public async search(\n    request: VectorSearchRequest,\n    auth: AuthContext,\n    accessToken: string,\n  ): Promise<{ results: VectorSearchResult[]; model: string; took_ms: number }> {\n    const startTime = Date.now();\n    const userId = getWebId(auth) ?? getAccountId(auth) ?? 'anonymous';\n\n    this.logger.info(`Vector search request from ${userId}, model: ${request.model}`);\n\n    let queryVector = request.vector;\n\n    // If query text provided, generate embedding\n    if (request.query && !queryVector) {\n      const credential = await this.getAiCredential(auth);\n      if (!credential) {\n        throw new Error('No AI credential found for embedding generation');\n      }\n      queryVector = await this.embeddingService.embed(request.query, credential, request.model);\n    }\n\n    if (!queryVector) {\n      throw new Error('Either query or vector must be provided');\n    }\n\n    // Call CSS vector API\n    const response = await this.callCssVectorApi('search', accessToken, {\n      model: request.model,\n      vector: queryVector,\n      limit: request.limit ?? 10,\n      threshold: request.threshold,\n      excludeIds: undefined, // TODO: implement filter to excludeIds conversion\n    });\n\n    // Map numeric IDs back to subject+aspect (requires metadata storage)\n    // For now, return IDs as subjects (external API Server should maintain mapping)\n    const results: VectorSearchResult[] = (response.results ?? []).map((r: any) => ({\n      subject: String(r.id), // Placeholder - actual mapping should be done by caller\n      aspect: '',\n      score: r.score,\n      distance: r.distance,\n    }));\n\n    return {\n      results,\n      model: request.model,\n      took_ms: Date.now() - startTime,\n    };\n  }\n\n  /**\n   * Delete vectors from CSS vector store\n   */\n  public async delete(\n    request: VectorDeleteRequest,\n    auth: AuthContext,\n    accessToken: string,\n  ): Promise<{ deleted: number; errors: string[]; took_ms: number }> {\n    const startTime = Date.now();\n    const userId = getWebId(auth) ?? getAccountId(auth) ?? 'anonymous';\n\n    this.logger.info(`Vector delete request from ${userId}, model: ${request.model}`);\n\n    // Convert filter to IDs (simplified - actual implementation needs metadata lookup)\n    const ids: number[] = [];\n\n    if (request.filter.subject?.$eq && request.filter.aspect?.$eq) {\n      ids.push(this.hashSubjectAspect(request.filter.subject.$eq, request.filter.aspect.$eq));\n    }\n\n    if (ids.length === 0) {\n      return { deleted: 0, errors: ['No matching vectors found'], took_ms: Date.now() - startTime };\n    }\n\n    // Call CSS vector API\n    const response = await this.callCssVectorApi('delete', accessToken, {\n      model: request.model,\n      ids,\n    });\n\n    return {\n      deleted: response.deleted ?? 0,\n      errors: response.errors ?? [],\n      took_ms: Date.now() - startTime,\n    };\n  }\n\n  /**\n   * Get vector store status\n   */\n  public async status(accessToken: string): Promise<VectorStatusResponse> {\n    const response = await this.callCssVectorApi('status', accessToken, undefined, 'GET');\n    return {\n      byModel: response.byModel ?? [],\n      totalCount: response.totalCount ?? 0,\n    };\n  }\n\n  /**\n   * Generate embedding for text\n   */\n  public async embed(\n    text: string,\n    model: string,\n    auth: AuthContext,\n  ): Promise<number[]> {\n    const credential = await this.getAiCredential(auth);\n\n    if (!credential) {\n      throw new Error('No AI credential found for embedding generation');\n    }\n\n    return this.embeddingService.embed(text, credential, model);\n  }\n\n  /**\n   * Generate embeddings for multiple texts\n   */\n  public async embedBatch(\n    texts: string[],\n    model: string,\n    auth: AuthContext,\n  ): Promise<number[][]> {\n    const credential = await this.getAiCredential(auth);\n\n    if (!credential) {\n      throw new Error('No AI credential found for embedding generation');\n    }\n\n    return this.embeddingService.embedBatch(texts, credential, model);\n  }\n\n  // ============================================\n  // Private methods\n  // ============================================\n\n  /**\n   * Create a StoreContext from AuthContext for Pod operations\n   */\n  private createStoreContext(auth: AuthContext): StoreContext {\n    return {\n      userId: getWebId(auth) ?? getAccountId(auth) ?? 'anonymous',\n      auth,\n    };\n  }\n\n  private async getAiCredential(auth: AuthContext): Promise<AiCredential | undefined> {\n    const context = this.createStoreContext(auth);\n    const config = await this.store.getAiConfig(context);\n    if (!config) {\n      return undefined;\n    }\n    return {\n      provider: config.providerId,\n      apiKey: config.apiKey,\n      baseUrl: config.baseUrl,\n      proxyUrl: config.proxyUrl,\n    };\n  }\n\n  private async callCssVectorApi(\n    action: string,\n    accessToken: string,\n    body?: unknown,\n    method: 'GET' | 'POST' | 'DELETE' = 'POST',\n  ): Promise<any> {\n    const url = `${this.cssBaseUrl}/-/vector/${action}`;\n\n    const options: RequestInit = {\n      method,\n      headers: {\n        'Authorization': `Bearer ${accessToken}`,\n        'Content-Type': 'application/json',\n      },\n    };\n\n    if (body && method !== 'GET') {\n      options.body = JSON.stringify(body);\n    }\n\n    this.logger.debug(`Calling CSS vector API: ${method} ${url}`);\n\n    const response = await fetch(url, options);\n\n    if (!response.ok) {\n      const errorText = await response.text();\n      this.logger.error(`CSS vector API error: ${response.status} ${errorText}`);\n      throw new Error(`CSS vector API error: ${response.status} ${response.statusText}`);\n    }\n\n    return response.json();\n  }\n\n  /**\n   * Hash subject + aspect to numeric ID\n   * Uses FNV-1a hash for good distribution\n   */\n  private hashSubjectAspect(subject: string, aspect: string): number {\n    const str = `${subject}|${aspect}`;\n    let hash = 2166136261; // FNV offset basis\n    for (let i = 0; i < str.length; i++) {\n      hash ^= str.charCodeAt(i);\n      hash = Math.imul(hash, 16777619); // FNV prime\n    }\n    return Math.abs(hash);\n  }\n}\n"]}