@ytinnovation/harness-core 0.0.0

package/dist/kernel/router.js

@@ -0,0 +1,73 @@
+import { HarnessError } from '../contracts/errors.js';
+import { renderErrorBlock } from '../cli-output/renderers.js';
+export class CommandRouter {
+    handlers = new Map();
+    programName;
+    constructor(programName = 'harness') {
+        this.programName = programName;
+    }
+    register(command, handler) {
+        const normalized = command.trim();
+        if (normalized.length === 0) {
+            throw new HarnessError('ROUTER_INVALID_CMD', 'Command name must not be empty.');
+        }
+        if (this.handlers.has(normalized)) {
+            throw new HarnessError('ROUTER_DUPLICATE_CMD', `Command "${normalized}" is already registered.`);
+        }
+        this.handlers.set(normalized, handler);
+    }
+    async dispatch(argv) {
+        if (argv.length === 0 || argv[0] === '--help' || argv[0] === '-h') {
+            return { exitCode: 0, message: this.renderHelp() };
+        }
+        const command = argv[0];
+        const handler = this.handlers.get(command);
+        if (!handler) {
+            return {
+                exitCode: 1,
+                message: renderErrorBlock({
+                    title: '未知命令',
+                    message: `无法识别命令：${command}`,
+                    code: 'ROUTER_UNKNOWN_COMMAND',
+                    suggestions: ['运行 harness --help 查看可用命令。'],
+                }) + `\n\n${this.renderHelp()}`,
+            };
+        }
+        try {
+            const code = await handler(argv.slice(1));
+            return { exitCode: code ?? 0 };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            return {
+                exitCode: 1,
+                message: renderErrorBlock({
+                    title: '命令执行失败',
+                    message: `命令 ${command} 执行失败：${message}`,
+                    code: 'ROUTER_COMMAND_FAILED',
+                }),
+            };
+        }
+    }
+    renderHelp() {
+        const commands = Array.from(this.handlers.keys()).sort();
+        const commandsOutput = commands.length === 0
+            ? '  （暂无已注册命令）'
+            : commands.map((cmd) => `  ${cmd}`).join('\n');
+        return [
+            `${this.programName} CLI`,
+            '',
+            '用法：',
+            `  ${this.programName} <command> [args]`,
+            '',
+            '命令：',
+            commandsOutput,
+            '',
+            '配置：',
+            '  优先级：CLI 参数 > harness.config.json > 环境变量 > 默认值。',
+            '  云端服务：HARNESS_SERVICE_URL 优先于 HARNESS_CLOUD_BASE_URL。',
+            '  如果启动前预加载 .env，则同样遵循环境变量优先级。',
+        ].join('\n');
+    }
+}
+//# sourceMappingURL=router.js.map

package/dist/kernel/router.js.map

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

package/dist/kernel/types.d.ts

@@ -0,0 +1,6 @@
+import type { CommandRouter } from './router.js';
+export interface Kernel {
+    readonly version: string;
+    readonly router: CommandRouter;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/kernel/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/kernel/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,MAAM;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;CAChC"}

package/dist/kernel/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/kernel/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/kernel/types.ts"],"names":[],"mappings":""}

package/dist/knowledge/command.d.ts

@@ -0,0 +1,6 @@
+import type { CommandRouter } from '../kernel/router.js';
+declare function renderKnowledgeHelp(programName?: string): string;
+export declare function runKnowledgeCommand(args: string[]): Promise<number>;
+export declare function registerKnowledgeCommand(router: CommandRouter): void;
+export { renderKnowledgeHelp };
+//# sourceMappingURL=command.d.ts.map

package/dist/knowledge/command.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command.d.ts","sourceRoot":"","sources":["../../src/knowledge/command.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAYzD,iBAAS,mBAAmB,CAAC,WAAW,SAAY,GAAG,MAAM,CAc5D;AAwGD,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC,CAoDzE;AAED,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI,CAEpE;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

package/dist/knowledge/command.js

@@ -0,0 +1,151 @@
+import { resolve } from 'node:path';
+import { queryHarnessRag } from '../cloud/rag-client.js';
+import { HarnessError } from '../contracts/errors.js';
+import { renderErrorBlock, renderJson } from '../cli-output/renderers.js';
+function renderKnowledgeHelp(programName = 'harness') {
+    return [
+        '查询企业知识库（harness-service RAG）。',
+        '',
+        '用法：',
+        `  ${programName} knowledge query --query <text> [--cwd <path>] [--max-results <n>] [--json]`,
+        '',
+        '选项：',
+        '  --query <text>      查询文本。',
+        '  --cwd <path>        工作区根目录，默认当前目录。',
+        '  --max-results <n>   限制返回文档数。',
+        '  --json              输出机器可读 JSON。',
+        '  -h, --help          查看帮助。',
+    ].join('\n');
+}
+function parsePositiveInteger(value) {
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isFinite(parsed) || parsed <= 0) {
+        throw new HarnessError('KNOWLEDGE_INVALID_ARGS', `Invalid value for --max-results: ${value}`);
+    }
+    return parsed;
+}
+function parseKnowledgeQueryArgs(args) {
+    let cwd = process.cwd();
+    let query;
+    let sourcePath;
+    let maxResults;
+    let json = false;
+    let help = false;
+    for (let index = 0; index < args.length; index += 1) {
+        const arg = args[index];
+        if (arg === '--help' || arg === '-h') {
+            help = true;
+            continue;
+        }
+        if (arg === '--json') {
+            json = true;
+            continue;
+        }
+        if (arg === '--cwd') {
+            const value = args[index + 1];
+            if (!value || value.startsWith('--')) {
+                throw new HarnessError('KNOWLEDGE_INVALID_ARGS', 'Missing value for --cwd.');
+            }
+            cwd = resolve(value);
+            index += 1;
+            continue;
+        }
+        if (arg === '--query') {
+            const value = args[index + 1];
+            if (!value || value.startsWith('--')) {
+                throw new HarnessError('KNOWLEDGE_INVALID_ARGS', 'Missing value for --query.');
+            }
+            query = value;
+            index += 1;
+            continue;
+        }
+        if (arg === '--source') {
+            const value = args[index + 1];
+            if (!value || value.startsWith('--')) {
+                throw new HarnessError('KNOWLEDGE_INVALID_ARGS', 'Missing value for --source.');
+            }
+            sourcePath = value;
+            index += 1;
+            continue;
+        }
+        if (arg === '--max-results') {
+            const value = args[index + 1];
+            if (!value || value.startsWith('--')) {
+                throw new HarnessError('KNOWLEDGE_INVALID_ARGS', 'Missing value for --max-results.');
+            }
+            maxResults = parsePositiveInteger(value);
+            index += 1;
+            continue;
+        }
+        throw new HarnessError('KNOWLEDGE_INVALID_ARGS', `Unknown knowledge query option: ${arg}`);
+    }
+    return {
+        cwd,
+        query,
+        sourcePath,
+        maxResults,
+        json,
+        help,
+    };
+}
+function printKnowledgeError(error, json) {
+    const payload = {
+        status: 'error',
+        errorCode: error.code,
+        message: error.message,
+    };
+    if (json) {
+        console.error(renderJson(payload));
+        return;
+    }
+    console.error(renderErrorBlock({
+        title: '知识库查询失败',
+        message: error.message,
+        code: error.code,
+    }));
+}
+export async function runKnowledgeCommand(args) {
+    if (args.length === 0 || args[0] === '--help' || args[0] === '-h') {
+        console.log(renderKnowledgeHelp());
+        return 0;
+    }
+    const subcommand = args[0];
+    if (subcommand !== 'query') {
+        throw new HarnessError('KNOWLEDGE_INVALID_ARGS', `Unknown knowledge subcommand: ${subcommand}`);
+    }
+    const options = parseKnowledgeQueryArgs(args.slice(1));
+    if (options.help) {
+        console.log(renderKnowledgeHelp());
+        return 0;
+    }
+    if (!options.query || options.query.trim().length === 0) {
+        throw new HarnessError('KNOWLEDGE_INVALID_ARGS', 'Query is required. Provide --query <text>.');
+    }
+    if (options.sourcePath) {
+        const error = new HarnessError('KNOWLEDGE_INVALID_ARGS', 'Local knowledge source override (--source) is no longer supported. Configure HARNESS_SERVICE_URL and use enterprise RAG.');
+        printKnowledgeError(error, options.json);
+        return 1;
+    }
+    try {
+        const ragResult = await queryHarnessRag({
+            query: options.query,
+            projectFingerprint: process.env.HARNESS_PROJECT_FINGERPRINT,
+            topK: options.maxResults,
+        }, { workspaceRoot: options.cwd });
+        const error = new HarnessError(ragResult.errorCode, `企业知识库未启用: ${ragResult.message}`);
+        printKnowledgeError(error, options.json);
+        return 1;
+    }
+    catch (error) {
+        if (error instanceof HarnessError) {
+            printKnowledgeError(error, options.json);
+            return 1;
+        }
+        throw error;
+    }
+}
+export function registerKnowledgeCommand(router) {
+    router.register('knowledge', runKnowledgeCommand);
+}
+export { renderKnowledgeHelp };
+//# sourceMappingURL=command.js.map

package/dist/knowledge/command.js.map

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

package/dist/knowledge/query.d.ts

@@ -0,0 +1,23 @@
+import { type KnowledgeQueryResponse } from './types.js';
+export interface QueryKnowledgeSourceOptions {
+    workspaceRoot: string;
+    query: string;
+    sourcePath?: string;
+    maxResults?: number;
+}
+export type QueryKnowledgeSourceResult = {
+    status: 'success';
+    configuredSourcePath: string;
+    resolvedSourcePath: string;
+    response: KnowledgeQueryResponse;
+} | {
+    status: 'unavailable';
+    message: string;
+    errorCode: 'KNOWLEDGE_SOURCE_UNAVAILABLE';
+} | {
+    status: 'error';
+    message: string;
+    errorCode: 'KNOWLEDGE_QUERY_INVALID';
+};
+export declare function queryKnowledgeSource(options: QueryKnowledgeSourceOptions): Promise<QueryKnowledgeSourceResult>;
+//# sourceMappingURL=query.d.ts.map

package/dist/knowledge/query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/knowledge/query.ts"],"names":[],"mappings":"AAEA,OAAO,EAAgE,KAAK,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAOvH,MAAM,WAAW,2BAA2B;IAC1C,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,MAAM,0BAA0B,GAClC;IACE,MAAM,EAAE,SAAS,CAAC;IAClB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,sBAAsB,CAAC;CAClC,GACD;IACE,MAAM,EAAE,aAAa,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,8BAA8B,CAAC;CAC3C,GACD;IACE,MAAM,EAAE,OAAO,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,yBAAyB,CAAC;CACtC,CAAC;AAiEN,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,0BAA0B,CAAC,CA2ErC"}

package/dist/knowledge/query.js

@@ -0,0 +1,133 @@
+import { readdir, readFile, stat } from 'node:fs/promises';
+import { basename, extname, join, relative, resolve } from 'node:path';
+import { createEmptyKnowledgeQueryResponse } from './types.js';
+const MAX_SCAN_FILES = 50;
+const MAX_FILE_BYTES = 256 * 1024;
+const MAX_SNIPPET_LENGTH = 180;
+const SCANNABLE_EXTENSIONS = new Set(['.md', '.markdown', '.txt', '.json', '.yaml', '.yml']);
+function isNodeError(error) {
+    return typeof error === 'object' && error !== null && 'code' in error;
+}
+function createSnippet(content, matchIndex) {
+    const start = Math.max(0, matchIndex - Math.floor(MAX_SNIPPET_LENGTH / 2));
+    const end = Math.min(content.length, start + MAX_SNIPPET_LENGTH);
+    return content
+        .slice(start, end)
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+async function collectSourceFiles(sourcePath) {
+    const details = await stat(sourcePath);
+    if (details.isDirectory()) {
+        const entries = await readdir(sourcePath, { withFileTypes: true });
+        return entries
+            .filter((entry) => entry.isFile())
+            .map((entry) => join(sourcePath, entry.name))
+            .filter((entryPath) => SCANNABLE_EXTENSIONS.has(extname(entryPath).toLowerCase()))
+            .slice(0, MAX_SCAN_FILES);
+    }
+    if (details.isFile()) {
+        return [sourcePath];
+    }
+    return null;
+}
+async function readTextFile(path) {
+    try {
+        const details = await stat(path);
+        if (details.size > MAX_FILE_BYTES) {
+            return null;
+        }
+        return await readFile(path, 'utf8');
+    }
+    catch {
+        return null;
+    }
+}
+function buildHit(filePath, workspaceRoot, content, query) {
+    const normalizedQuery = query.toLowerCase();
+    const normalizedContent = content.toLowerCase();
+    const matchIndex = normalizedContent.indexOf(normalizedQuery);
+    if (matchIndex === -1) {
+        return null;
+    }
+    const relativePath = relative(workspaceRoot, filePath);
+    return {
+        documentId: relativePath.length > 0 ? relativePath : basename(filePath),
+        title: basename(filePath),
+        snippet: createSnippet(content, matchIndex),
+        sourceLabel: 'workspace-knowledge',
+        sourceUri: relativePath.length > 0 ? relativePath : undefined,
+        score: Number((1 - matchIndex / Math.max(1, normalizedContent.length)).toFixed(3)),
+        tags: [],
+    };
+}
+export async function queryKnowledgeSource(options) {
+    const query = options.query.trim();
+    if (query.length === 0) {
+        return {
+            status: 'error',
+            message: 'Query is required. Provide a non-empty query.',
+            errorCode: 'KNOWLEDGE_QUERY_INVALID',
+        };
+    }
+    const configuredSourcePath = options.sourcePath?.trim();
+    if (!configuredSourcePath) {
+        return {
+            status: 'unavailable',
+            message: 'No knowledge source configured.',
+            errorCode: 'KNOWLEDGE_SOURCE_UNAVAILABLE',
+        };
+    }
+    const resolvedSourcePath = resolve(options.workspaceRoot, configuredSourcePath);
+    let sourceFiles = null;
+    try {
+        sourceFiles = await collectSourceFiles(resolvedSourcePath);
+    }
+    catch (error) {
+        if (isNodeError(error) && error.code === 'ENOENT') {
+            return {
+                status: 'unavailable',
+                message: `Configured knowledge source does not exist: ${configuredSourcePath}.`,
+                errorCode: 'KNOWLEDGE_SOURCE_UNAVAILABLE',
+            };
+        }
+        return {
+            status: 'error',
+            message: `Failed to inspect configured knowledge source: ${configuredSourcePath}.`,
+            errorCode: 'KNOWLEDGE_QUERY_INVALID',
+        };
+    }
+    if (!sourceFiles || sourceFiles.length === 0) {
+        return {
+            status: 'success',
+            configuredSourcePath,
+            resolvedSourcePath,
+            response: createEmptyKnowledgeQueryResponse(query),
+        };
+    }
+    const hits = [];
+    for (const filePath of sourceFiles) {
+        const content = await readTextFile(filePath);
+        if (!content) {
+            continue;
+        }
+        const hit = buildHit(filePath, options.workspaceRoot, content, query);
+        if (hit) {
+            hits.push(hit);
+        }
+    }
+    const maxResults = typeof options.maxResults === 'number' && Number.isFinite(options.maxResults)
+        ? Math.max(0, Math.floor(options.maxResults))
+        : hits.length;
+    const limitedHits = hits.slice(0, maxResults);
+    const response = createEmptyKnowledgeQueryResponse(query);
+    response.hits = limitedHits;
+    response.totalHits = limitedHits.length;
+    return {
+        status: 'success',
+        configuredSourcePath,
+        resolvedSourcePath,
+        response,
+    };
+}
+//# sourceMappingURL=query.js.map

package/dist/knowledge/query.js.map

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

package/dist/knowledge/rag.d.ts

@@ -0,0 +1,74 @@
+import type { KnowledgePermissionSummary, KnowledgeQueryInput, KnowledgeQueryResponse } from './types.js';
+export type RagOperation = 'index' | 'retrieve' | 'rerank';
+export interface RagCitationMetadata {
+    sourceId: string;
+    sourceLabel: string;
+    sourceUri?: string;
+    chunkId?: string;
+    retrievedAt: string;
+}
+export interface RagPermissionSummary {
+    scope: KnowledgePermissionSummary['scope'];
+    redacted: boolean;
+    reason?: string;
+}
+export interface RagIndexDocument {
+    documentId: string;
+    title?: string;
+    content: string;
+    metadata?: Record<string, string>;
+}
+export interface RagIndexRequest {
+    operation: 'index';
+    workspaceRoot: string;
+    actorId?: string;
+    documents: RagIndexDocument[];
+}
+export interface RagRetrieveRequest {
+    operation: 'retrieve';
+    workspaceRoot: string;
+    query: string;
+    actorId?: string;
+    maxResults?: number;
+}
+export interface RagRerankCandidate {
+    documentId: string;
+    snippet: string;
+    score?: number;
+    citations?: RagCitationMetadata[];
+}
+export interface RagRerankRequest {
+    operation: 'rerank';
+    query: string;
+    candidates: RagRerankCandidate[];
+    maxResults?: number;
+}
+export interface RagRetrieveHit {
+    documentId: string;
+    title: string;
+    snippet: string;
+    score: number;
+    citations: RagCitationMetadata[];
+    tags?: string[];
+}
+export interface RagRetrieveResponse {
+    status: 'success';
+    operation: 'retrieve';
+    query: string;
+    hits: RagRetrieveHit[];
+    totalHits: number;
+    permissions: RagPermissionSummary;
+}
+export interface RagUnavailableResponse {
+    status: 'unavailable';
+    errorCode: 'RAG_UNAVAILABLE';
+    message: string;
+    permissionSafe: true;
+    operations: RagOperation[];
+}
+export declare function createEmptyRagRetrieveResponse(query: string, permissions?: RagPermissionSummary): RagRetrieveResponse;
+export declare function mapKnowledgeQueryInputToRagRetrieveRequest(input: KnowledgeQueryInput): RagRetrieveRequest;
+export declare function mapKnowledgeQueryResponseToRagRetrieveResponse(response: KnowledgeQueryResponse, options?: {
+    retrievedAt?: string;
+}): RagRetrieveResponse;
+//# sourceMappingURL=rag.d.ts.map

package/dist/knowledge/rag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rag.d.ts","sourceRoot":"","sources":["../../src/knowledge/rag.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAEV,0BAA0B,EAC1B,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAEpB,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;AAE3D,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,oBAAoB;IACnC,KAAK,EAAE,0BAA0B,CAAC,OAAO,CAAC,CAAC;IAC3C,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,gBAAgB,EAAE,CAAC;CAC/B;AAED,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,UAAU,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,mBAAmB,EAAE,CAAC;CACnC;AAED,MAAM,WAAW,gBAAgB;IAC/B,SAAS,EAAE,QAAQ,CAAC;IACpB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,kBAAkB,EAAE,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,mBAAmB,EAAE,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,SAAS,CAAC;IAClB,SAAS,EAAE,UAAU,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,cAAc,EAAE,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,oBAAoB,CAAC;CACnC;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,aAAa,CAAC;IACtB,SAAS,EAAE,iBAAiB,CAAC;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,IAAI,CAAC;IACrB,UAAU,EAAE,YAAY,EAAE,CAAC;CAC5B;AAED,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,MAAM,EACb,WAAW,GAAE,oBAGZ,GACA,mBAAmB,CASrB;AAED,wBAAgB,0CAA0C,CAAC,KAAK,EAAE,mBAAmB,GAAG,kBAAkB,CAQzG;AAED,wBAAgB,8CAA8C,CAC5D,QAAQ,EAAE,sBAAsB,EAChC,OAAO,GAAE;IACP,WAAW,CAAC,EAAE,MAAM,CAAC;CACjB,GACL,mBAAmB,CAerB"}

package/dist/knowledge/rag.js

@@ -0,0 +1,55 @@
+export function createEmptyRagRetrieveResponse(query, permissions = {
+    scope: 'workspace',
+    redacted: false,
+}) {
+    return {
+        status: 'success',
+        operation: 'retrieve',
+        query,
+        hits: [],
+        totalHits: 0,
+        permissions,
+    };
+}
+export function mapKnowledgeQueryInputToRagRetrieveRequest(input) {
+    return {
+        operation: 'retrieve',
+        workspaceRoot: input.workspaceRoot,
+        query: input.query,
+        actorId: input.actorId,
+        maxResults: input.maxResults,
+    };
+}
+export function mapKnowledgeQueryResponseToRagRetrieveResponse(response, options = {}) {
+    const retrievedAt = options.retrievedAt ?? new Date().toISOString();
+    const mappedHits = response.hits.map((hit) => mapKnowledgeHitToRagHit(hit, retrievedAt));
+    return {
+        status: 'success',
+        operation: 'retrieve',
+        query: response.query,
+        hits: mappedHits,
+        totalHits: mappedHits.length,
+        permissions: {
+            scope: response.permissions.scope,
+            redacted: response.permissions.redacted,
+            reason: response.permissions.reason,
+        },
+    };
+}
+function mapKnowledgeHitToRagHit(hit, retrievedAt) {
+    const citation = {
+        sourceId: hit.documentId,
+        sourceLabel: hit.sourceLabel,
+        sourceUri: hit.sourceUri,
+        retrievedAt,
+    };
+    return {
+        documentId: hit.documentId,
+        title: hit.title,
+        snippet: hit.snippet,
+        score: hit.score,
+        citations: [citation],
+        tags: hit.tags,
+    };
+}
+//# sourceMappingURL=rag.js.map

package/dist/knowledge/rag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rag.js","sourceRoot":"","sources":["../../src/knowledge/rag.ts"],"names":[],"mappings":"AAqFA,MAAM,UAAU,8BAA8B,CAC5C,KAAa,EACb,cAAoC;IAClC,KAAK,EAAE,WAAW;IAClB,QAAQ,EAAE,KAAK;CAChB;IAED,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,SAAS,EAAE,UAAU;QACrB,KAAK;QACL,IAAI,EAAE,EAAE;QACR,SAAS,EAAE,CAAC;QACZ,WAAW;KACZ,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0CAA0C,CAAC,KAA0B;IACnF,OAAO;QACL,SAAS,EAAE,UAAU;QACrB,aAAa,EAAE,KAAK,CAAC,aAAa;QAClC,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,OAAO,EAAE,KAAK,CAAC,OAAO;QACtB,UAAU,EAAE,KAAK,CAAC,UAAU;KAC7B,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,8CAA8C,CAC5D,QAAgC,EAChC,UAEI,EAAE;IAEN,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACpE,MAAM,UAAU,GAAG,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,uBAAuB,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC,CAAC;IACzF,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,SAAS,EAAE,UAAU;QACrB,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,IAAI,EAAE,UAAU;QAChB,SAAS,EAAE,UAAU,CAAC,MAAM;QAC5B,WAAW,EAAE;YACX,KAAK,EAAE,QAAQ,CAAC,WAAW,CAAC,KAAK;YACjC,QAAQ,EAAE,QAAQ,CAAC,WAAW,CAAC,QAAQ;YACvC,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,MAAM;SACpC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,uBAAuB,CAAC,GAAyB,EAAE,WAAmB;IAC7E,MAAM,QAAQ,GAAwB;QACpC,QAAQ,EAAE,GAAG,CAAC,UAAU;QACxB,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,SAAS,EAAE,GAAG,CAAC,SAAS;QACxB,WAAW;KACZ,CAAC;IACF,OAAO;QACL,UAAU,EAAE,GAAG,CAAC,UAAU;QAC1B,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,SAAS,EAAE,CAAC,QAAQ,CAAC;QACrB,IAAI,EAAE,GAAG,CAAC,IAAI;KACf,CAAC;AACJ,CAAC"}

package/dist/knowledge/types.d.ts

@@ -0,0 +1,40 @@
+export interface KnowledgeQueryInput {
+    query: string;
+    workspaceRoot: string;
+    actorId?: string;
+    maxResults?: number;
+    filters?: {
+        tags?: string[];
+        sourceIds?: string[];
+    };
+}
+export interface KnowledgeDocumentHit {
+    documentId: string;
+    title: string;
+    snippet: string;
+    sourceLabel: string;
+    sourceUri?: string;
+    score: number;
+    tags?: string[];
+}
+export interface KnowledgePermissionSummary {
+    scope: 'workspace' | 'team' | 'org';
+    redacted: boolean;
+    reason?: string;
+}
+export interface KnowledgeQueryResponse {
+    status: 'success';
+    query: string;
+    hits: KnowledgeDocumentHit[];
+    totalHits: number;
+    permissions: KnowledgePermissionSummary;
+}
+export interface KnowledgeQueryError {
+    status: 'error';
+    errorCode: 'KNOWLEDGE_SOURCE_UNAVAILABLE' | 'KNOWLEDGE_QUERY_INVALID' | 'KNOWLEDGE_PERMISSION_DENIED';
+    message: string;
+    retryable: boolean;
+}
+export type KnowledgeQueryResult = KnowledgeQueryResponse | KnowledgeQueryError;
+export declare function createEmptyKnowledgeQueryResponse(query: string, permissions?: KnowledgePermissionSummary): KnowledgeQueryResponse;
+//# sourceMappingURL=types.d.ts.map

package/dist/knowledge/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/knowledge/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,MAAM,CAAC;IACd,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE;QACR,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;KACtB,CAAC;CACH;AAED,MAAM,WAAW,oBAAoB;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;CACjB;AAED,MAAM,WAAW,0BAA0B;IACzC,KAAK,EAAE,WAAW,GAAG,MAAM,GAAG,KAAK,CAAC;IACpC,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,oBAAoB,EAAE,CAAC;IAC7B,SAAS,EAAE,MAAM,CAAC;IAClB,WAAW,EAAE,0BAA0B,CAAC;CACzC;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EACL,8BAA8B,GAC9B,yBAAyB,GACzB,6BAA6B,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,oBAAoB,GAAG,sBAAsB,GAAG,mBAAmB,CAAC;AAEhF,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,MAAM,EACb,WAAW,GAAE,0BAGZ,GACA,sBAAsB,CAQxB"}

package/dist/knowledge/types.js

@@ -0,0 +1,13 @@
+export function createEmptyKnowledgeQueryResponse(query, permissions = {
+    scope: 'workspace',
+    redacted: false,
+}) {
+    return {
+        status: 'success',
+        query,
+        hits: [],
+        totalHits: 0,
+        permissions,
+    };
+}
+//# sourceMappingURL=types.js.map

package/dist/knowledge/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/knowledge/types.ts"],"names":[],"mappings":"AA+CA,MAAM,UAAU,iCAAiC,CAC/C,KAAa,EACb,cAA0C;IACxC,KAAK,EAAE,WAAW;IAClB,QAAQ,EAAE,KAAK;CAChB;IAED,OAAO;QACL,MAAM,EAAE,SAAS;QACjB,KAAK;QACL,IAAI,EAAE,EAAE;QACR,SAAS,EAAE,CAAC;QACZ,WAAW;KACZ,CAAC;AACJ,CAAC"}