@pellux/goodvibes-sdk 0.18.3 → 0.18.11

package/dist/platform/knowledge/extractors.js

@@ -0,0 +1,518 @@
+import JSZip from 'jszip';
+import { extname } from 'node:path';
+import { guessMimeType } from '../artifacts/types.js';
+function decodeHtmlEntities(value) {
+    return value
+        .replace(/ /g, ' ')
+        .replace(/&/g, '&')
+        .replace(/&lt;/g, '<')
+        .replace(/&gt;/g, '>')
+        .replace(/&quot;/g, '"')
+        .replace(/&#39;/g, "'");
+}
+function stripHtml(value) {
+    return decodeHtmlEntities(value
+        .replace(/<script[\s\S]*?<\/script>/gi, ' ')
+        .replace(/<style[\s\S]*?<\/style>/gi, ' ')
+        .replace(/<[^>]+>/g, ' ')
+        .replace(/\s+/g, ' ')
+        .trim());
+}
+function cleanText(value) {
+    return value
+        .replace(/\u0000/g, ' ')
+        .replace(/\r\n/g, '\n')
+        .replace(/\r/g, '\n')
+        .replace(/[ \t]+\n/g, '\n')
+        .replace(/\n{3,}/g, '\n\n')
+        .replace(/[ \t]{2,}/g, ' ')
+        .trim();
+}
+function estimateTokens(...chunks) {
+    const total = chunks
+        .filter((value) => typeof value === 'string')
+        .reduce((sum, value) => sum + value.length, 0);
+    return Math.max(1, Math.ceil(total / 4));
+}
+function firstNonEmptyLine(value) {
+    return value
+        .split(/\n+/)
+        .map((line) => line.trim())
+        .find(Boolean);
+}
+function summarizeText(text, maxLength = 320) {
+    const cleaned = cleanText(text);
+    if (!cleaned)
+        return undefined;
+    if (cleaned.length <= maxLength)
+        return cleaned;
+    const sentence = cleaned.match(/^(.{0,320}?[.!?])(?:\s|$)/)?.[1]?.trim();
+    return sentence && sentence.length >= 40 ? sentence : `${cleaned.slice(0, maxLength - 1).trim()}…`;
+}
+function excerptText(text, maxLength = 480) {
+    const cleaned = cleanText(text);
+    if (!cleaned)
+        return undefined;
+    return cleaned.length <= maxLength ? cleaned : `${cleaned.slice(0, maxLength - 1).trim()}…`;
+}
+function uniqueStrings(values, limit = 24) {
+    const seen = new Set();
+    const result = [];
+    for (const value of values) {
+        const trimmed = cleanText(value);
+        if (!trimmed || seen.has(trimmed))
+            continue;
+        seen.add(trimmed);
+        result.push(trimmed);
+        if (result.length >= limit)
+            break;
+    }
+    return result;
+}
+function decodeBuffer(buffer) {
+    return cleanText(buffer.toString('utf-8'));
+}
+function extractLinksFromHtml(html) {
+    const urls = [];
+    const regex = /\bhref=["']([^"'#]+)["']/gi;
+    let match;
+    while ((match = regex.exec(html)) !== null) {
+        const candidate = match[1]?.trim();
+        if (candidate)
+            urls.push(candidate);
+    }
+    return uniqueStrings(urls, 50);
+}
+function extractHtml(buffer) {
+    const html = buffer.toString('utf-8');
+    const title = cleanText(html.match(/<title[^>]*>([\s\S]*?)<\/title>/i)?.[1] ?? '')
+        || cleanText(html.match(/<h1[^>]*>([\s\S]*?)<\/h1>/i)?.[1] ?? '');
+    const headings = uniqueStrings(Array.from(html.matchAll(/<h([1-3])[^>]*>([\s\S]*?)<\/h\1>/gi), (match) => stripHtml(match[2] ?? '')), 16);
+    const paragraphs = uniqueStrings(Array.from(html.matchAll(/<p[^>]*>([\s\S]*?)<\/p>/gi), (match) => stripHtml(match[1] ?? '')), 8);
+    const readable = stripHtml(html);
+    const summary = summarizeText([headings[0], paragraphs[0], readable].filter(Boolean).join(' '));
+    return {
+        extractorId: 'html',
+        format: 'html',
+        ...(title ? { title } : {}),
+        ...(summary ? { summary } : {}),
+        ...(excerptText(readable) ? { excerpt: excerptText(readable) } : {}),
+        sections: headings.length > 0 ? headings : uniqueStrings(readable.split(/\n+/), 8),
+        links: extractLinksFromHtml(html),
+        estimatedTokens: estimateTokens(title, summary, readable),
+        structure: {
+            headings,
+            paragraphCount: paragraphs.length,
+            readableLength: readable.length,
+        },
+        metadata: {
+            paragraphSamples: paragraphs.slice(0, 4),
+        },
+    };
+}
+function extractTextLike(buffer, format, extractorId) {
+    const text = decodeBuffer(buffer);
+    const lines = text.split(/\n+/).map((line) => line.trim()).filter(Boolean);
+    const headings = lines.filter((line) => /^#{1,6}\s+/.test(line)).map((line) => line.replace(/^#{1,6}\s+/, ''));
+    const sections = headings.length > 0 ? headings : uniqueStrings(lines.slice(0, 8), 8);
+    const title = headings[0] ?? firstNonEmptyLine(text);
+    const summary = summarizeText(text);
+    const links = uniqueStrings(Array.from(text.matchAll(/\bhttps?:\/\/[^\s)>"']+/g), (match) => match[0]), 50);
+    return {
+        extractorId,
+        format,
+        ...(title ? { title } : {}),
+        ...(summary ? { summary } : {}),
+        ...(excerptText(text) ? { excerpt: excerptText(text) } : {}),
+        sections,
+        links,
+        estimatedTokens: estimateTokens(text),
+        structure: {
+            lineCount: lines.length,
+            headingCount: headings.length,
+        },
+        metadata: {},
+    };
+}
+function extractJson(buffer) {
+    const text = decodeBuffer(buffer);
+    try {
+        const parsed = JSON.parse(text);
+        const rootKeys = typeof parsed === 'object' && parsed !== null && !Array.isArray(parsed)
+            ? Object.keys(parsed).slice(0, 24)
+            : [];
+        const title = rootKeys.length > 0 ? `JSON object: ${rootKeys.slice(0, 3).join(', ')}` : 'JSON document';
+        const summary = Array.isArray(parsed)
+            ? `JSON array with ${parsed.length} item(s).`
+            : `JSON object with ${rootKeys.length} top-level key(s).`;
+        return {
+            extractorId: 'json',
+            format: 'json',
+            title,
+            summary,
+            excerpt: excerptText(text),
+            sections: rootKeys,
+            links: uniqueStrings(Array.from(text.matchAll(/\bhttps?:\/\/[^\s",]+/g), (match) => match[0]), 50),
+            estimatedTokens: estimateTokens(text),
+            structure: {
+                rootType: Array.isArray(parsed) ? 'array' : typeof parsed,
+                rootKeys,
+                itemCount: Array.isArray(parsed) ? parsed.length : undefined,
+            },
+            metadata: {},
+        };
+    }
+    catch {
+        return extractTextLike(buffer, 'json', 'json-fallback');
+    }
+}
+function parseDelimited(text, delimiter) {
+    const lines = text.split(/\r?\n/).map((line) => line.trim()).filter(Boolean);
+    if (lines.length === 0)
+        return { headers: [], rows: [] };
+    const parseLine = (line) => {
+        const cells = [];
+        let current = '';
+        let inQuotes = false;
+        for (let index = 0; index < line.length; index += 1) {
+            const char = line[index];
+            if (char === '"') {
+                if (inQuotes && line[index + 1] === '"') {
+                    current += '"';
+                    index += 1;
+                }
+                else {
+                    inQuotes = !inQuotes;
+                }
+                continue;
+            }
+            if (char === delimiter && !inQuotes) {
+                cells.push(current.trim());
+                current = '';
+                continue;
+            }
+            current += char;
+        }
+        cells.push(current.trim());
+        return cells;
+    };
+    return {
+        headers: parseLine(lines[0]),
+        rows: lines.slice(1, 6).map(parseLine),
+    };
+}
+function extractDelimited(buffer, delimiter, format) {
+    const text = decodeBuffer(buffer);
+    const { headers, rows } = parseDelimited(text, delimiter);
+    const summary = headers.length > 0
+        ? `${format.toUpperCase()} table with ${headers.length} column(s); sampled ${rows.length} row(s).`
+        : `${format.toUpperCase()} table.`;
+    return {
+        extractorId: format,
+        format,
+        title: headers.length > 0 ? `${format.toUpperCase()} sheet: ${headers.slice(0, 3).join(', ')}` : `${format.toUpperCase()} data`,
+        summary,
+        excerpt: excerptText(text),
+        sections: headers,
+        links: uniqueStrings(Array.from(text.matchAll(/\bhttps?:\/\/[^\s",]+/g), (match) => match[0]), 50),
+        estimatedTokens: estimateTokens(text),
+        structure: {
+            headers,
+            sampleRows: rows,
+            rowCountSampled: rows.length,
+        },
+        metadata: {},
+    };
+}
+function extractXml(buffer) {
+    const text = decodeBuffer(buffer);
+    const tags = uniqueStrings(Array.from(text.matchAll(/<([a-zA-Z0-9:_-]+)(?:\s|>)/g), (match) => match[1] ?? ''), 20);
+    const readable = cleanText(decodeHtmlEntities(text.replace(/<[^>]+>/g, ' ')));
+    return {
+        extractorId: 'xml',
+        format: 'xml',
+        title: tags[0] ? `XML: <${tags[0]}>` : 'XML document',
+        summary: summarizeText(readable) ?? 'XML document.',
+        excerpt: excerptText(readable),
+        sections: tags,
+        links: uniqueStrings(Array.from(text.matchAll(/\bhttps?:\/\/[^\s"'<]+/g), (match) => match[0]), 50),
+        estimatedTokens: estimateTokens(readable),
+        structure: { tags },
+        metadata: {},
+    };
+}
+function extractYaml(buffer) {
+    const text = decodeBuffer(buffer);
+    const keys = uniqueStrings(Array.from(text.matchAll(/^([A-Za-z0-9_.-]+):/gm), (match) => match[1] ?? ''), 24);
+    return {
+        extractorId: 'yaml',
+        format: 'yaml',
+        title: keys[0] ? `YAML: ${keys.slice(0, 3).join(', ')}` : 'YAML document',
+        summary: summarizeText(text) ?? 'YAML document.',
+        excerpt: excerptText(text),
+        sections: keys.length > 0 ? keys : uniqueStrings(text.split(/\n+/), 8),
+        links: uniqueStrings(Array.from(text.matchAll(/\bhttps?:\/\/[^\s"']+/g), (match) => match[0]), 50),
+        estimatedTokens: estimateTokens(text),
+        structure: { keys },
+        metadata: {},
+    };
+}
+function extractPdf(buffer) {
+    const body = buffer.toString('latin1');
+    const texts = [];
+    const streamRe = /stream\r?\n([\s\S]*?)\r?\nendstream/g;
+    let match;
+    while ((match = streamRe.exec(body)) !== null) {
+        const chunk = match[1];
+        const parenRe = /\(([^)\\]*(?:\\.[^)\\]*)*)\)/g;
+        let textMatch;
+        while ((textMatch = parenRe.exec(chunk)) !== null) {
+            const text = cleanText(textMatch[1]
+                .replace(/\\n/g, '\n')
+                .replace(/\\r/g, '\r')
+                .replace(/\\t/g, '\t')
+                .replace(/\\\\/g, '\\')
+                .replace(/\\\(/g, '(')
+                .replace(/\\\)/g, ')'));
+            if (text.length > 1)
+                texts.push(text);
+        }
+    }
+    const combined = uniqueStrings(texts, 64).join('\n');
+    return {
+        extractorId: 'pdf',
+        format: 'pdf',
+        title: firstNonEmptyLine(combined) ?? 'PDF document',
+        summary: summarizeText(combined) ?? 'PDF extraction produced limited text; OCR is not used in-core.',
+        excerpt: excerptText(combined),
+        sections: uniqueStrings(combined.split(/\n+/), 8),
+        links: uniqueStrings(Array.from(combined.matchAll(/\bhttps?:\/\/[^\s)]+/g), (match) => match[0]), 50),
+        estimatedTokens: estimateTokens(combined),
+        structure: {
+            extractedStringCount: texts.length,
+        },
+        metadata: {
+            limitations: texts.length === 0
+                ? ['No readable text streams were found. Complex PDFs need OCR or a dedicated provider.']
+                : ['PDF extraction is best-effort and does not use OCR.'],
+        },
+    };
+}
+async function extractDocx(buffer) {
+    const zip = await JSZip.loadAsync(buffer);
+    const file = zip.file('word/document.xml');
+    if (!file)
+        return extractTextLike(buffer, 'docx', 'docx-fallback');
+    const xml = await file.async('string');
+    const paragraphs = uniqueStrings(Array.from(xml.matchAll(/<w:p[\s\S]*?<\/w:p>/g), (match) => {
+        const text = Array.from(match[0].matchAll(/<w:t[^>]*>([\s\S]*?)<\/w:t>/g), (part) => decodeHtmlEntities(part[1] ?? '')).join('');
+        return text;
+    }), 48);
+    const headings = uniqueStrings(Array.from(xml.matchAll(/<w:p[\s\S]*?<w:pStyle[^>]*w:val="Heading[0-9]+"[\s\S]*?<\/w:p>/g), (match) => {
+        const text = Array.from(match[0].matchAll(/<w:t[^>]*>([\s\S]*?)<\/w:t>/g), (part) => decodeHtmlEntities(part[1] ?? '')).join('');
+        return text;
+    }), 12);
+    const text = paragraphs.join('\n\n');
+    return {
+        extractorId: 'docx',
+        format: 'docx',
+        title: headings[0] ?? paragraphs[0] ?? 'DOCX document',
+        summary: summarizeText(text) ?? 'DOCX document.',
+        excerpt: excerptText(text),
+        sections: headings.length > 0 ? headings : paragraphs.slice(0, 8),
+        links: uniqueStrings(Array.from(text.matchAll(/\bhttps?:\/\/[^\s)]+/g), (match) => match[0]), 50),
+        estimatedTokens: estimateTokens(text),
+        structure: {
+            paragraphCount: paragraphs.length,
+            headingCount: headings.length,
+        },
+        metadata: {},
+    };
+}
+function readSharedStrings(xml) {
+    return Array.from(xml.matchAll(/<t[^>]*>([\s\S]*?)<\/t>/g), (match) => decodeHtmlEntities(match[1] ?? ''));
+}
+async function extractXlsx(buffer) {
+    const zip = await JSZip.loadAsync(buffer);
+    const workbookXml = await zip.file('xl/workbook.xml')?.async('string') ?? '';
+    const sharedStringsXml = await zip.file('xl/sharedStrings.xml')?.async('string') ?? '';
+    const sharedStrings = readSharedStrings(sharedStringsXml);
+    const sheetNames = uniqueStrings(Array.from(workbookXml.matchAll(/<sheet[^>]+name="([^"]+)"/g), (match) => decodeHtmlEntities(match[1] ?? '')), 20);
+    const sampleSheets = [];
+    const sheetEntries = Object.keys(zip.files)
+        .filter((name) => /^xl\/worksheets\/sheet\d+\.xml$/i.test(name))
+        .sort((a, b) => a.localeCompare(b))
+        .slice(0, 3);
+    for (const [index, sheetPath] of sheetEntries.entries()) {
+        const xml = await zip.file(sheetPath)?.async('string');
+        if (!xml)
+            continue;
+        const rows = Array.from(xml.matchAll(/<row[^>]*>([\s\S]*?)<\/row>/g), (rowMatch) => {
+            return Array.from(rowMatch[1].matchAll(/<c[^>]*?(?:\st="([^"]+)")?[^>]*>([\s\S]*?)<\/c>/g), (cellMatch) => {
+                const type = cellMatch[1] ?? '';
+                const body = cellMatch[2] ?? '';
+                const raw = body.match(/<v[^>]*>([\s\S]*?)<\/v>/)?.[1]
+                    ?? body.match(/<t[^>]*>([\s\S]*?)<\/t>/)?.[1]
+                    ?? '';
+                const value = type === 's'
+                    ? (sharedStrings[Number(raw)] ?? raw)
+                    : decodeHtmlEntities(raw);
+                return cleanText(value);
+            }).filter(Boolean);
+        }).filter((row) => row.length > 0).slice(0, 6);
+        sampleSheets.push({
+            name: sheetNames[index] ?? sheetPath,
+            rows,
+        });
+    }
+    const flatText = sampleSheets.flatMap((sheet) => [sheet.name, ...sheet.rows.flatMap((row) => row)]).join('\n');
+    return {
+        extractorId: 'xlsx',
+        format: 'xlsx',
+        title: sheetNames[0] ? `Workbook: ${sheetNames[0]}` : 'XLSX workbook',
+        summary: sheetNames.length > 0
+            ? `Workbook with ${sheetNames.length} sheet(s): ${sheetNames.slice(0, 4).join(', ')}.`
+            : 'XLSX workbook.',
+        excerpt: excerptText(flatText),
+        sections: sheetNames,
+        links: uniqueStrings(Array.from(flatText.matchAll(/\bhttps?:\/\/[^\s)]+/g), (match) => match[0]), 50),
+        estimatedTokens: estimateTokens(flatText),
+        structure: {
+            sheetNames,
+            sampleSheets,
+        },
+        metadata: {},
+    };
+}
+async function extractPptx(buffer) {
+    const zip = await JSZip.loadAsync(buffer);
+    const slideEntries = Object.keys(zip.files)
+        .filter((name) => /^ppt\/slides\/slide\d+\.xml$/i.test(name))
+        .sort((a, b) => a.localeCompare(b))
+        .slice(0, 12);
+    const slides = [];
+    for (const path of slideEntries) {
+        const xml = await zip.file(path)?.async('string');
+        if (!xml)
+            continue;
+        const text = uniqueStrings(Array.from(xml.matchAll(/<a:t[^>]*>([\s\S]*?)<\/a:t>/g), (match) => decodeHtmlEntities(match[1] ?? '')), 64).join('\n');
+        if (!text)
+            continue;
+        slides.push({
+            title: firstNonEmptyLine(text) ?? path,
+            text,
+        });
+    }
+    const combined = slides.map((slide) => `${slide.title}\n${slide.text}`).join('\n\n');
+    return {
+        extractorId: 'pptx',
+        format: 'pptx',
+        title: slides[0]?.title ?? 'PPTX deck',
+        summary: slides.length > 0 ? `Slide deck with ${slides.length} extracted slide(s).` : 'PPTX deck.',
+        excerpt: excerptText(combined),
+        sections: slides.map((slide) => slide.title).slice(0, 12),
+        links: uniqueStrings(Array.from(combined.matchAll(/\bhttps?:\/\/[^\s)]+/g), (match) => match[0]), 50),
+        estimatedTokens: estimateTokens(combined),
+        structure: {
+            slideCount: slides.length,
+            slides: slides.slice(0, 6),
+        },
+        metadata: {},
+    };
+}
+function chooseFormat(artifact) {
+    const mime = artifact.mimeType.toLowerCase();
+    const filenameType = guessMimeType(artifact.filename);
+    const effective = mime === 'application/octet-stream' ? filenameType : mime;
+    if (effective === 'text/markdown')
+        return 'markdown';
+    if (effective === 'text/html')
+        return 'html';
+    if (effective === 'application/json')
+        return 'json';
+    if (effective === 'text/csv')
+        return 'csv';
+    if (effective === 'text/tab-separated-values')
+        return 'tsv';
+    if (effective === 'application/xml' || effective === 'text/xml')
+        return 'xml';
+    if (effective === 'application/yaml' || effective === 'text/yaml' || effective === 'text/x-yaml')
+        return 'yaml';
+    if (effective === 'application/vnd.openxmlformats-officedocument.wordprocessingml.document')
+        return 'docx';
+    if (effective === 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet')
+        return 'xlsx';
+    if (effective === 'application/vnd.openxmlformats-officedocument.presentationml.presentation')
+        return 'pptx';
+    if (effective === 'application/pdf')
+        return 'pdf';
+    if (effective.startsWith('text/'))
+        return 'text';
+    const ext = extname((artifact.filename ?? '').toLowerCase());
+    if (ext === '.md' || ext === '.markdown')
+        return 'markdown';
+    if (ext === '.json')
+        return 'json';
+    if (ext === '.csv')
+        return 'csv';
+    if (ext === '.tsv')
+        return 'tsv';
+    if (ext === '.xml')
+        return 'xml';
+    if (ext === '.yaml' || ext === '.yml')
+        return 'yaml';
+    if (ext === '.docx')
+        return 'docx';
+    if (ext === '.xlsx')
+        return 'xlsx';
+    if (ext === '.pptx')
+        return 'pptx';
+    if (ext === '.pdf')
+        return 'pdf';
+    return 'unknown';
+}
+export async function extractKnowledgeArtifact(artifact, buffer) {
+    const format = chooseFormat(artifact);
+    switch (format) {
+        case 'html':
+            return extractHtml(buffer);
+        case 'markdown':
+            return extractTextLike(buffer, 'markdown', 'markdown');
+        case 'json':
+            return extractJson(buffer);
+        case 'csv':
+            return extractDelimited(buffer, ',', 'csv');
+        case 'tsv':
+            return extractDelimited(buffer, '\t', 'tsv');
+        case 'xml':
+            return extractXml(buffer);
+        case 'yaml':
+            return extractYaml(buffer);
+        case 'docx':
+            return extractDocx(buffer);
+        case 'xlsx':
+            return extractXlsx(buffer);
+        case 'pptx':
+            return extractPptx(buffer);
+        case 'pdf':
+            return extractPdf(buffer);
+        case 'text':
+            return extractTextLike(buffer, 'text', 'text');
+        default:
+            return {
+                extractorId: 'binary-fallback',
+                format: 'unknown',
+                title: artifact.filename ?? artifact.id,
+                summary: `Stored artifact ${artifact.filename ?? artifact.id} (${artifact.mimeType}) has no specialized in-core extractor yet.`,
+                sections: [],
+                links: [],
+                estimatedTokens: 1,
+                structure: {
+                    mimeType: artifact.mimeType,
+                },
+                metadata: {
+                    limitations: ['No specialized extractor matched this artifact type.'],
+                },
+            };
+    }
+}

package/dist/platform/knowledge/graphql-schema.d.ts

@@ -0,0 +1,45 @@
+import { buildSchema, type DocumentNode, type ValueNode } from 'graphql';
+import type { KnowledgePacketDetail, KnowledgeProjectionTargetKind } from './types.js';
+export declare const KNOWLEDGE_GRAPHQL_SDL = "\n  scalar JSON\n\n  enum KnowledgeProjectionKind {\n    OVERVIEW\n    BUNDLE\n    SOURCE\n    NODE\n    ISSUE\n    DASHBOARD\n    ROLLUP\n  }\n\n  enum KnowledgePacketDetail {\n    COMPACT\n    STANDARD\n    DETAILED\n  }\n\n  enum KnowledgeJobMode {\n    INLINE\n    BACKGROUND\n  }\n\n  type KnowledgeStatus {\n    ready: Boolean!\n    storagePath: String!\n    sourceCount: Int!\n    nodeCount: Int!\n    edgeCount: Int!\n    issueCount: Int!\n    extractionCount: Int!\n    jobRunCount: Int!\n    usageCount: Int!\n    candidateCount: Int!\n    reportCount: Int!\n    scheduleCount: Int!\n    note: String!\n  }\n\n  type KnowledgeConnectorSetupField {\n    key: String!\n    label: String!\n    kind: String!\n    optional: Boolean\n    source: String\n    description: String\n  }\n\n  type KnowledgeConnectorSetup {\n    version: String!\n    summary: String!\n    transportHints: [String!]!\n    steps: [String!]!\n    fields: [KnowledgeConnectorSetupField!]!\n    metadata: JSON\n  }\n\n  type KnowledgeConnectorDoctorCheck {\n    id: String!\n    label: String!\n    status: String!\n    detail: String!\n    metadata: JSON\n  }\n\n  type KnowledgeConnectorDoctorReport {\n    connectorId: String!\n    ready: Boolean!\n    summary: String!\n    checks: [KnowledgeConnectorDoctorCheck!]!\n    hints: [String!]!\n    metadata: JSON\n  }\n\n  type KnowledgeConnector {\n    id: String!\n    displayName: String\n    version: String\n    description: String!\n    sourceType: String!\n    inputSchema: JSON\n    examples: [JSON!]!\n    capabilities: [String!]!\n    setup: KnowledgeConnectorSetup\n    metadata: JSON\n  }\n\n  type KnowledgeSource {\n    id: String!\n    connectorId: String!\n    sourceType: String!\n    title: String\n    sourceUri: String\n    canonicalUri: String\n    summary: String\n    description: String\n    tags: [String!]!\n    folderPath: String\n    status: String!\n    artifactId: String\n    contentHash: String\n    lastCrawledAt: Float\n    crawlError: String\n    sessionId: String\n    metadata: JSON\n    createdAt: Float!\n    updatedAt: Float!\n  }\n\n  type KnowledgeNode {\n    id: String!\n    kind: String!\n    slug: String!\n    title: String!\n    summary: String\n    aliases: [String!]!\n    status: String!\n    confidence: Int!\n    sourceId: String\n    metadata: JSON\n    createdAt: Float!\n    updatedAt: Float!\n  }\n\n  type KnowledgeEdge {\n    id: String!\n    fromKind: String!\n    fromId: String!\n    toKind: String!\n    toId: String!\n    relation: String!\n    weight: Float!\n    metadata: JSON\n    createdAt: Float!\n    updatedAt: Float!\n  }\n\n  type KnowledgeIssue {\n    id: String!\n    severity: String!\n    code: String!\n    message: String!\n    status: String!\n    sourceId: String\n    nodeId: String\n    metadata: JSON\n    createdAt: Float!\n    updatedAt: Float!\n  }\n\n  type KnowledgeExtraction {\n    id: String!\n    sourceId: String!\n    artifactId: String\n    extractorId: String!\n    format: String!\n    title: String\n    summary: String\n    excerpt: String\n    sections: [String!]!\n    links: [String!]!\n    estimatedTokens: Int!\n    structure: JSON\n    metadata: JSON\n    createdAt: Float!\n    updatedAt: Float!\n  }\n\n  type KnowledgeItemView {\n    source: KnowledgeSource\n    node: KnowledgeNode\n    issue: KnowledgeIssue\n    relatedEdges: [KnowledgeEdge!]!\n    linkedSources: [KnowledgeSource!]!\n    linkedNodes: [KnowledgeNode!]!\n  }\n\n  type KnowledgeSearchResult {\n    kind: String!\n    id: String!\n    score: Float!\n    reason: String!\n    source: KnowledgeSource\n    node: KnowledgeNode\n  }\n\n  type KnowledgePacketItem {\n    kind: String!\n    id: String!\n    title: String!\n    summary: String\n    uri: String\n    reason: String!\n    score: Float!\n    estimatedTokens: Int!\n    related: [String!]!\n    evidence: [String!]!\n    metadata: JSON\n  }\n\n  type KnowledgePacket {\n    task: String!\n    writeScope: [String!]!\n    generatedAt: Float!\n    detail: KnowledgePacketDetail!\n    strategy: String!\n    budgetLimit: Int!\n    estimatedTokens: Int!\n    items: [KnowledgePacketItem!]!\n  }\n\n  type KnowledgeProjectionTarget {\n    targetId: String!\n    kind: KnowledgeProjectionKind!\n    title: String!\n    description: String!\n    itemId: String\n    defaultPath: String!\n    defaultFilename: String!\n    metadata: JSON\n  }\n\n  type KnowledgeProjectionPage {\n    path: String!\n    title: String!\n    format: String!\n    content: String!\n    itemIds: [String!]!\n    metadata: JSON\n  }\n\n  type KnowledgeProjectionBundle {\n    id: String!\n    target: KnowledgeProjectionTarget!\n    generatedAt: Float!\n    pageCount: Int!\n    pages: [KnowledgeProjectionPage!]!\n    metadata: JSON\n  }\n\n  type ArtifactDescriptor {\n    id: String!\n    kind: String!\n    mimeType: String!\n    filename: String\n    sizeBytes: Int!\n    sourceUri: String\n    createdAt: Float!\n    metadata: JSON\n  }\n\n  type KnowledgeJob {\n    id: String!\n    label: String!\n    description: String!\n    defaultMode: KnowledgeJobMode!\n    triggerKinds: [String!]!\n    lastRunAt: Float\n    metadata: JSON\n  }\n\n  type KnowledgeJobRun {\n    id: String!\n    jobId: String!\n    status: String!\n    mode: KnowledgeJobMode!\n    requestedAt: Float!\n    startedAt: Float\n    completedAt: Float\n    error: String\n    result: JSON\n    metadata: JSON\n  }\n\n  type KnowledgeBatchIngestResult {\n    imported: Int!\n    failed: Int!\n    sources: [KnowledgeSource!]!\n    errors: [String!]!\n  }\n\n  type KnowledgeUsageRecord {\n    id: String!\n    targetKind: String!\n    targetId: String!\n    usageKind: String!\n    task: String\n    sessionId: String\n    score: Float\n    metadata: JSON\n    createdAt: Float!\n  }\n\n  type KnowledgeConsolidationCandidate {\n    id: String!\n    candidateType: String!\n    status: String!\n    subjectKind: String!\n    subjectId: String!\n    title: String!\n    summary: String\n    score: Float!\n    evidence: [String!]!\n    suggestedMemoryClass: String\n    suggestedScope: String\n    decidedAt: Float\n    decidedBy: String\n    metadata: JSON\n    createdAt: Float!\n    updatedAt: Float!\n  }\n\n  type KnowledgeConsolidationReport {\n    id: String!\n    kind: String!\n    title: String!\n    summary: String!\n    highlights: [String!]!\n    metrics: JSON\n    metadata: JSON\n    createdAt: Float!\n    updatedAt: Float!\n  }\n\n  type KnowledgeSchedule {\n    id: String!\n    jobId: String!\n    label: String!\n    enabled: Boolean!\n    schedule: JSON!\n    lastRunAt: Float\n    nextRunAt: Float\n    metadata: JSON\n    createdAt: Float!\n    updatedAt: Float!\n  }\n\n  input KnowledgeJobRunInput {\n    mode: KnowledgeJobMode\n  }\n\n  input KnowledgePacketInput {\n    task: String!\n    writeScope: [String!]\n    limit: Int\n    detail: KnowledgePacketDetail\n    budgetLimit: Int\n  }\n\n  type Query {\n    status: KnowledgeStatus!\n    connectors: [KnowledgeConnector!]!\n    connectorDoctor(id: String!): KnowledgeConnectorDoctorReport\n    sources(limit: Int, offset: Int): [KnowledgeSource!]!\n    nodes(limit: Int, offset: Int): [KnowledgeNode!]!\n    issues(limit: Int, offset: Int): [KnowledgeIssue!]!\n    itemView(kind: String!, id: String!): KnowledgeItemView\n    extractions(limit: Int, sourceId: String): [KnowledgeExtraction!]!\n    neighbors(kind: String!, id: String!, relation: String, limit: Int): [KnowledgeEdge!]!\n    search(query: String!, limit: Int): [KnowledgeSearchResult!]!\n    packet(task: String!, writeScope: [String!], limit: Int, detail: KnowledgePacketDetail, budgetLimit: Int): KnowledgePacket!\n    projectionTargets(limit: Int): [KnowledgeProjectionTarget!]!\n    projection(kind: KnowledgeProjectionKind!, id: String, limit: Int): KnowledgeProjectionBundle!\n    jobs: [KnowledgeJob!]!\n    job(id: String!): KnowledgeJob\n    jobRuns(limit: Int, jobId: String): [KnowledgeJobRun!]!\n    usage(limit: Int, targetKind: String, targetId: String, usageKind: String): [KnowledgeUsageRecord!]!\n    usageRecords(limit: Int, targetKind: String, targetId: String, usageKind: String): [KnowledgeUsageRecord!]!\n    consolidationCandidates(limit: Int, status: String): [KnowledgeConsolidationCandidate!]!\n    consolidationReports(limit: Int): [KnowledgeConsolidationReport!]!\n    schedules(limit: Int): [KnowledgeSchedule!]!\n    sourceExtraction(sourceId: String!): KnowledgeExtraction\n  }\n\n  type Mutation {\n    ingestUrl(url: String!, sourceType: String, connectorId: String, folderPath: String, tags: [String!], sessionId: String, allowPrivateHosts: Boolean): KnowledgeSource!\n    ingestArtifact(path: String!, connectorId: String, tags: [String!], sessionId: String, allowPrivateHosts: Boolean): KnowledgeSource!\n    importBookmarksFromFile(path: String!, sessionId: String, allowPrivateHosts: Boolean): KnowledgeBatchIngestResult!\n    importUrlsFromFile(path: String!, sessionId: String, allowPrivateHosts: Boolean): KnowledgeBatchIngestResult!\n    ingestBookmarkSeeds(seeds: [String!]!, connectorId: String, sessionId: String): KnowledgeBatchIngestResult!\n    ingestWithConnector(connectorId: String!, input: String!, sessionId: String, allowPrivateHosts: Boolean): KnowledgeBatchIngestResult!\n    ingestConnectorInput(input: String!, connectorId: String, sessionId: String, allowPrivateHosts: Boolean): KnowledgeBatchIngestResult!\n    renderProjection(kind: KnowledgeProjectionKind!, id: String, limit: Int): KnowledgeProjectionBundle!\n    materializeProjection(kind: KnowledgeProjectionKind!, id: String, limit: Int): KnowledgeMaterializedProjection!\n    reindex: KnowledgeStatus!\n    runJob(id: String!, mode: KnowledgeJobMode): KnowledgeJobRun!\n    saveSchedule(id: String, jobId: String!, label: String!, enabled: Boolean!, schedule: JSON!, metadata: JSON): KnowledgeSchedule!\n    deleteSchedule(id: String!): Boolean!\n    setScheduleEnabled(id: String!, enabled: Boolean!): KnowledgeSchedule\n    decideConsolidationCandidate(id: String!, status: String!, decidedBy: String): KnowledgeConsolidationCandidate!\n    lint: [KnowledgeIssue!]!\n  }\n\n  type KnowledgeMaterializedProjection {\n    artifact: ArtifactDescriptor!\n    bundle: KnowledgeProjectionBundle!\n  }\n";
+export declare function parseJsonAst(node: ValueNode): unknown;
+export declare function installJsonScalar(schema: ReturnType<typeof buildSchema>): void;
+export declare function toProjectionKind(value: string): KnowledgeProjectionTargetKind;
+export declare function toProjectionEnum(value: string | undefined): string;
+export declare function toPacketDetail(value: string | undefined): KnowledgePacketDetail;
+export declare function toPacketDetailEnum(value: string | undefined): string;
+export declare function toJobMode(value: string | undefined): 'inline' | 'background';
+export declare function toJobModeEnum(value: string | undefined): string;
+export declare function mapProjectionTarget<T extends {
+    kind?: string;
+}>(target: T): T & {
+    kind: string;
+};
+export declare function mapProjectionBundle<T extends {
+    target: {
+        kind?: string;
+    };
+    pages: readonly unknown[];
+}>(bundle: T): T & {
+    target: {
+        kind: string;
+    };
+};
+export declare function mapPacket<T extends {
+    detail?: string;
+}>(packet: T): T & {
+    detail: string;
+};
+export declare function mapJob<T extends {
+    defaultMode?: string;
+}>(job: T): T & {
+    defaultMode: string;
+};
+export declare function mapJobRun<T extends {
+    mode?: string;
+}>(run: T): T & {
+    mode: string;
+};
+export declare function clampInt(value: number | null | undefined, fallback: number): number;
+export declare function clampOffset(value: number | null | undefined): number;
+export declare function pickOperation(document: DocumentNode, operationName?: string): 'query' | 'mutation';
+//# sourceMappingURL=graphql-schema.d.ts.map

package/dist/platform/knowledge/graphql-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graphql-schema.d.ts","sourceRoot":"","sources":["../../../src/platform/knowledge/graphql-schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,WAAW,EACX,KAAK,YAAY,EACjB,KAAK,SAAS,EACf,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,qBAAqB,EAAE,6BAA6B,EAAE,MAAM,YAAY,CAAC;AAEvF,eAAO,MAAM,qBAAqB,siUA8YjC,CAAC;AAEF,wBAAgB,YAAY,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAoBrD;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,CAAC,OAAO,WAAW,CAAC,GAAG,IAAI,CAQ9E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,6BAA6B,CAuB7E;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAiBlE;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,qBAAqB,CAM/E;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAEpE;AAED,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,YAAY,CAE5E;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAE/D;AAED,wBAAgB,mBAAmB,CAAC,CAAC,SAAS;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAKhG;AAED,wBAAgB,mBAAmB,CAAC,CAAC,SAAS;IAAE,MAAM,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAAC,KAAK,EAAE,SAAS,OAAO,EAAE,CAAA;CAAE,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG;IAAE,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAKnJ;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE,CAK1F;AAED,wBAAgB,MAAM,CAAC,CAAC,SAAS;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG;IAAE,WAAW,EAAE,MAAM,CAAA;CAAE,CAK9F;AAED,wBAAgB,SAAS,CAAC,CAAC,SAAS;IAAE,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAKnF;AAED,wBAAgB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEnF;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAEpE;AAED,wBAAgB,aAAa,CAAC,QAAQ,EAAE,YAAY,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,UAAU,CASlG"}