@pellux/goodvibes-daemon-sdk 0.18.3

package/dist/knowledge-routes.js

@@ -0,0 +1,582 @@
+import { buildMissingScopeBody, resolvePrivateHostFetchOptions, } from './http-policy.js';
+import { jsonErrorResponse, summarizeErrorForRecord } from './error-response.js';
+export function createDaemonKnowledgeRouteHandlers(context) {
+    return {
+        getKnowledgeStatus: async () => Response.json(await context.knowledgeService.getStatus()),
+        getKnowledgeSources: async (url) => Response.json({ sources: context.knowledgeService.listSources(readLimit(url, 100)) }),
+        getKnowledgeNodes: async (url) => Response.json({ nodes: context.knowledgeService.listNodes(readLimit(url, 100)) }),
+        getKnowledgeIssues: async (url) => Response.json({ issues: context.knowledgeService.listIssues(readLimit(url, 100)) }),
+        getKnowledgeItem: (id) => {
+            const item = context.knowledgeService.getItem(id);
+            return item
+                ? Response.json(item)
+                : Response.json({ error: 'Unknown knowledge item' }, { status: 404 });
+        },
+        getKnowledgeConnectors: () => Response.json({ connectors: context.knowledgeService.listConnectors() }),
+        getKnowledgeConnector: (id) => {
+            const connector = context.knowledgeService.getConnector(id);
+            return connector
+                ? Response.json({ connector })
+                : Response.json({ error: 'Unknown knowledge connector' }, { status: 404 });
+        },
+        getKnowledgeConnectorDoctor: async (id) => {
+            const report = await context.knowledgeService.doctorConnector(id);
+            return report
+                ? Response.json({ report })
+                : Response.json({ error: 'Unknown knowledge connector' }, { status: 404 });
+        },
+        getKnowledgeProjectionTargets: async (url) => Response.json({ targets: await context.knowledgeService.listProjectionTargets(readLimit(url, 25)) }),
+        getKnowledgeGraphqlSchema: () => Response.json({
+            language: 'graphql',
+            domain: 'knowledge',
+            schema: context.knowledgeGraphqlService.schemaText,
+        }),
+        getKnowledgeExtractions: async (url) => {
+            const sourceId = url.searchParams.get('sourceId') ?? undefined;
+            return Response.json({ extractions: context.knowledgeService.listExtractions(readLimit(url, 100), sourceId) });
+        },
+        getKnowledgeUsage: async (url) => {
+            const targetKind = url.searchParams.get('targetKind') ?? undefined;
+            const targetId = url.searchParams.get('targetId') ?? undefined;
+            const usageKind = url.searchParams.get('usageKind') ?? undefined;
+            return Response.json({
+                usage: context.knowledgeService.listUsageRecords(readLimit(url, 100), {
+                    ...(targetKind ? { targetKind: targetKind } : {}),
+                    ...(targetId ? { targetId } : {}),
+                    ...(usageKind ? { usageKind: usageKind } : {}),
+                }),
+            });
+        },
+        getKnowledgeCandidates: async (url) => {
+            const status = url.searchParams.get('status') ?? undefined;
+            const subjectKind = url.searchParams.get('subjectKind') ?? undefined;
+            const subjectId = url.searchParams.get('subjectId') ?? undefined;
+            return Response.json({
+                candidates: context.knowledgeService.listConsolidationCandidates(readLimit(url, 100), {
+                    ...(status ? { status: status } : {}),
+                    ...(subjectKind ? { subjectKind: subjectKind } : {}),
+                    ...(subjectId ? { subjectId } : {}),
+                }),
+            });
+        },
+        getKnowledgeCandidate: (id) => {
+            const candidate = context.knowledgeService.getConsolidationCandidate(id);
+            return candidate
+                ? Response.json({ candidate })
+                : Response.json({ error: 'Unknown knowledge consolidation candidate' }, { status: 404 });
+        },
+        getKnowledgeReports: async (url) => Response.json({ reports: context.knowledgeService.listConsolidationReports(readLimit(url, 100)) }),
+        getKnowledgeReport: (id) => {
+            const report = context.knowledgeService.getConsolidationReport(id);
+            return report
+                ? Response.json({ report })
+                : Response.json({ error: 'Unknown knowledge consolidation report' }, { status: 404 });
+        },
+        getKnowledgeExtraction: (id) => {
+            const extraction = context.knowledgeService.getExtraction(id);
+            return extraction
+                ? Response.json({ extraction })
+                : Response.json({ error: 'Unknown knowledge extraction' }, { status: 404 });
+        },
+        getKnowledgeSourceExtraction: (id) => {
+            const extraction = context.knowledgeService.getSourceExtraction(id);
+            return extraction
+                ? Response.json({ extraction })
+                : Response.json({ error: 'Unknown source extraction' }, { status: 404 });
+        },
+        getKnowledgeJobs: () => Response.json({ jobs: context.knowledgeService.listJobs() }),
+        getKnowledgeJob: (jobId) => {
+            const job = context.knowledgeService.getJob(jobId);
+            return job
+                ? Response.json({ job })
+                : Response.json({ error: 'Unknown knowledge job' }, { status: 404 });
+        },
+        getKnowledgeJobRuns: (url) => {
+            const jobId = url.searchParams.get('jobId') ?? undefined;
+            return Response.json({ runs: context.knowledgeService.listJobRuns(readLimit(url, 25), jobId) });
+        },
+        getKnowledgeSchedules: (url) => Response.json({ schedules: context.knowledgeService.listSchedules(readLimit(url, 100)) }),
+        getKnowledgeSchedule: (id) => {
+            const schedule = context.knowledgeService.getSchedule(id);
+            return schedule
+                ? Response.json({ schedule })
+                : Response.json({ error: 'Unknown knowledge schedule' }, { status: 404 });
+        },
+        postKnowledgeIngestUrl: async (request) => handleKnowledgeIngestUrl(context, request),
+        postKnowledgeIngestArtifact: async (request) => handleKnowledgeIngestArtifact(context, request),
+        postKnowledgeImportBookmarks: async (request) => handleKnowledgeImportBookmarks(context, request),
+        postKnowledgeImportUrls: async (request) => handleKnowledgeImportUrls(context, request),
+        postKnowledgeIngestConnector: async (request) => handleKnowledgeIngestConnector(context, request),
+        postKnowledgeSearch: async (request) => handleKnowledgeSearch(context, request),
+        postKnowledgePacket: async (request) => handleKnowledgePacket(context, request),
+        postKnowledgeDecideCandidate: async (id, request) => handleKnowledgeDecideCandidate(context, id, request),
+        postKnowledgeRunJob: async (jobId, request) => handleKnowledgeRunJob(context, jobId, request),
+        postKnowledgeLint: async (request) => {
+            const admin = context.requireAdmin(request);
+            if (admin)
+                return admin;
+            return Response.json({ issues: await context.knowledgeService.lint() });
+        },
+        postKnowledgeReindex: async (request) => {
+            const admin = context.requireAdmin(request);
+            if (admin)
+                return admin;
+            return Response.json(await context.knowledgeService.reindex());
+        },
+        postKnowledgeSaveSchedule: async (request) => handleKnowledgeSaveSchedule(context, request),
+        deleteKnowledgeSchedule: async (id, request) => {
+            const admin = context.requireAdmin(request);
+            if (admin)
+                return admin;
+            const deleted = await context.knowledgeService.deleteSchedule(id);
+            return deleted
+                ? Response.json({ deleted: true })
+                : Response.json({ error: 'Unknown knowledge schedule' }, { status: 404 });
+        },
+        postKnowledgeSetScheduleEnabled: async (id, request) => handleKnowledgeSetScheduleEnabled(context, id, request),
+        postKnowledgeRenderProjection: async (request) => handleKnowledgeRenderProjection(context, request),
+        postKnowledgeMaterializeProjection: async (request) => handleKnowledgeMaterializeProjection(context, request),
+        executeKnowledgeGraphql: async (request) => handleKnowledgeGraphql(context, request),
+    };
+}
+function readLimit(url, fallback) {
+    return Math.max(1, Number(url.searchParams.get('limit') ?? fallback) || fallback);
+}
+function readKnowledgeProjectionRequest(body) {
+    const rawKind = typeof body.kind === 'string' ? body.kind.trim().toLowerCase() : '';
+    if (rawKind !== 'overview'
+        && rawKind !== 'bundle'
+        && rawKind !== 'source'
+        && rawKind !== 'node'
+        && rawKind !== 'issue') {
+        return Response.json({ error: 'Projection kind must be one of overview, bundle, source, node, or issue.' }, { status: 400 });
+    }
+    const id = typeof body.id === 'string' ? body.id.trim() : '';
+    if ((rawKind === 'source' || rawKind === 'node' || rawKind === 'issue') && !id) {
+        return Response.json({ error: `Projection kind ${rawKind} requires id.` }, { status: 400 });
+    }
+    return {
+        kind: rawKind,
+        ...(id ? { id } : {}),
+        ...(typeof body.limit === 'number' ? { limit: Math.max(1, body.limit) } : {}),
+    };
+}
+function readKnowledgeSchedule(context, value) {
+    if (typeof value !== 'object' || value === null) {
+        return Response.json({ error: 'Missing schedule object' }, { status: 400 });
+    }
+    const schedule = value;
+    const kind = typeof schedule.kind === 'string' ? schedule.kind.trim().toLowerCase() : '';
+    try {
+        switch (kind) {
+            case 'every':
+                if (typeof schedule.intervalMs === 'number') {
+                    return context.normalizeEverySchedule(schedule.intervalMs, typeof schedule.anchorAt === 'number' ? schedule.anchorAt : undefined);
+                }
+                if (typeof schedule.interval === 'string') {
+                    return context.normalizeEverySchedule(schedule.interval, typeof schedule.anchorAt === 'number' ? schedule.anchorAt : undefined);
+                }
+                throw new Error('Every schedule requires intervalMs or interval.');
+            case 'cron':
+                if (typeof schedule.expression !== 'string' || !schedule.expression.trim()) {
+                    throw new Error('Cron schedule requires expression.');
+                }
+                return context.normalizeCronSchedule(schedule.expression, typeof schedule.timezone === 'string' ? schedule.timezone : undefined, schedule.staggerMs);
+            case 'at':
+                if (typeof schedule.at !== 'number')
+                    throw new Error('At schedule requires at.');
+                return context.normalizeAtSchedule(schedule.at);
+            default:
+                throw new Error('Schedule kind must be at, every, or cron.');
+        }
+    }
+    catch (error) {
+        return jsonErrorResponse(error, { status: 400 });
+    }
+}
+function readGraphqlVariables(value, parseJsonText) {
+    if (value === undefined || value === null || value === '')
+        return undefined;
+    if (typeof value === 'string') {
+        const parsed = parseJsonText(value);
+        if (parsed instanceof Response)
+            return parsed;
+        return parsed;
+    }
+    if (typeof value === 'object') {
+        return value;
+    }
+    return Response.json({ error: 'GraphQL variables must be an object or JSON string.' }, { status: 400 });
+}
+async function parseKnowledgeGraphqlRequest(context, req) {
+    if (req.method === 'GET') {
+        const url = new URL(req.url);
+        const query = url.searchParams.get('query')?.trim() ?? '';
+        if (!query)
+            return Response.json({ error: 'Missing query' }, { status: 400 });
+        const variables = readGraphqlVariables(url.searchParams.get('variables'), context.parseJsonText);
+        if (variables instanceof Response)
+            return variables;
+        const operationName = url.searchParams.get('operationName')?.trim();
+        return {
+            query,
+            ...(operationName ? { operationName } : {}),
+            ...(variables ? { variables } : {}),
+        };
+    }
+    const contentType = req.headers.get('content-type')?.toLowerCase() ?? '';
+    if (contentType.startsWith('application/graphql')) {
+        const query = (await req.text()).trim();
+        return query
+            ? { query }
+            : Response.json({ error: 'Missing query' }, { status: 400 });
+    }
+    const body = await context.parseOptionalJsonBody(req);
+    if (body instanceof Response)
+        return body;
+    if (!body)
+        return Response.json({ error: 'Missing query' }, { status: 400 });
+    const query = typeof body.query === 'string' ? body.query.trim() : '';
+    if (!query)
+        return Response.json({ error: 'Missing query' }, { status: 400 });
+    const variables = readGraphqlVariables(body.variables, context.parseJsonText);
+    if (variables instanceof Response)
+        return variables;
+    const operationName = typeof body.operationName === 'string' ? body.operationName.trim() : '';
+    return {
+        query,
+        ...(operationName ? { operationName } : {}),
+        ...(variables ? { variables } : {}),
+    };
+}
+async function handleKnowledgeGraphql(context, req) {
+    const parsed = await parseKnowledgeGraphqlRequest(context, req);
+    if (parsed instanceof Response)
+        return parsed;
+    if (req.method === 'GET' && /\bmutation\b/.test(parsed.query)) {
+        return Response.json({ error: 'GraphQL mutations must use POST.' }, { status: 405 });
+    }
+    const principal = context.resolveAuthenticatedPrincipal(req);
+    if (!principal) {
+        return Response.json({ error: 'Unauthorized' }, { status: 401 });
+    }
+    let access;
+    try {
+        access = context.inspectGraphqlAccess(parsed.query, parsed.operationName);
+    }
+    catch (error) {
+        return jsonErrorResponse(error, { status: 400 });
+    }
+    const scopeDenied = buildMissingScopeBody('knowledge GraphQL operation', access.requiredScopes, principal.scopes);
+    if (scopeDenied) {
+        return Response.json(scopeDenied, { status: 403 });
+    }
+    if (access.adminRequired && !principal.admin) {
+        return Response.json({ error: 'Knowledge GraphQL mutation requires admin access.' }, { status: 403 });
+    }
+    const result = await context.knowledgeGraphqlService.execute({
+        query: parsed.query,
+        ...(parsed.operationName ? { operationName: parsed.operationName } : {}),
+        ...(parsed.variables ? { variables: parsed.variables } : {}),
+        admin: principal.admin,
+        scopes: principal.scopes,
+    });
+    const status = result.errors?.length && !result.data ? 400 : 200;
+    return Response.json(result, { status });
+}
+function buildKnowledgePrivateHostFetchOptions(context, requested) {
+    return resolvePrivateHostFetchOptions(requested, {
+        configManager: context.configManager,
+    });
+}
+async function handleKnowledgeIngestUrl(context, request) {
+    const admin = context.requireAdmin(request);
+    if (admin)
+        return admin;
+    const body = await context.parseJsonBody(request);
+    if (body instanceof Response)
+        return body;
+    const url = typeof body.url === 'string' ? body.url.trim() : '';
+    if (!url)
+        return Response.json({ error: 'Missing url' }, { status: 400 });
+    const privateHostFetchOptions = buildKnowledgePrivateHostFetchOptions(context, body.allowPrivateHosts);
+    if (privateHostFetchOptions instanceof Response)
+        return privateHostFetchOptions;
+    try {
+        return Response.json(await context.knowledgeService.ingestUrl({
+            url,
+            ...(typeof body.title === 'string' ? { title: body.title } : {}),
+            ...(typeof body.folderPath === 'string' ? { folderPath: body.folderPath } : {}),
+            ...(Array.isArray(body.tags) ? { tags: body.tags.filter((entry) => typeof entry === 'string') } : {}),
+            ...(typeof body.sessionId === 'string' ? { sessionId: body.sessionId } : {}),
+            ...(typeof body.sourceType === 'string' ? { sourceType: body.sourceType } : {}),
+            ...(typeof body.connectorId === 'string' ? { connectorId: body.connectorId } : {}),
+            ...privateHostFetchOptions,
+            ...(typeof body.metadata === 'object' && body.metadata !== null ? { metadata: body.metadata } : {}),
+        }), { status: 201 });
+    }
+    catch (error) {
+        return jsonErrorResponse(error, { status: 400 });
+    }
+}
+async function handleKnowledgeIngestArtifact(context, request) {
+    const admin = context.requireAdmin(request);
+    if (admin)
+        return admin;
+    const body = await context.parseJsonBody(request);
+    if (body instanceof Response)
+        return body;
+    const privateHostFetchOptions = buildKnowledgePrivateHostFetchOptions(context, body.allowPrivateHosts);
+    if (privateHostFetchOptions instanceof Response)
+        return privateHostFetchOptions;
+    try {
+        return Response.json(await context.knowledgeService.ingestArtifact({
+            ...(typeof body.artifactId === 'string' ? { artifactId: body.artifactId } : {}),
+            ...(typeof body.path === 'string' ? { path: body.path } : {}),
+            ...(typeof body.uri === 'string' ? { uri: body.uri } : {}),
+            ...(typeof body.title === 'string' ? { title: body.title } : {}),
+            ...(typeof body.folderPath === 'string' ? { folderPath: body.folderPath } : {}),
+            ...(Array.isArray(body.tags) ? { tags: body.tags.filter((entry) => typeof entry === 'string') } : {}),
+            ...(typeof body.sessionId === 'string' ? { sessionId: body.sessionId } : {}),
+            ...(typeof body.sourceType === 'string' ? { sourceType: body.sourceType } : {}),
+            ...(typeof body.connectorId === 'string' ? { connectorId: body.connectorId } : {}),
+            ...privateHostFetchOptions,
+            ...(typeof body.metadata === 'object' && body.metadata !== null ? { metadata: body.metadata } : {}),
+        }), { status: 201 });
+    }
+    catch (error) {
+        return jsonErrorResponse(error, { status: 400 });
+    }
+}
+async function handleKnowledgeImportBookmarks(context, request) {
+    const admin = context.requireAdmin(request);
+    if (admin)
+        return admin;
+    const body = await context.parseJsonBody(request);
+    if (body instanceof Response)
+        return body;
+    const path = typeof body.path === 'string' ? body.path.trim() : '';
+    if (!path)
+        return Response.json({ error: 'Missing path' }, { status: 400 });
+    const privateHostFetchOptions = buildKnowledgePrivateHostFetchOptions(context, body.allowPrivateHosts);
+    if (privateHostFetchOptions instanceof Response)
+        return privateHostFetchOptions;
+    try {
+        return Response.json(await context.knowledgeService.importBookmarksFromFile({
+            path,
+            ...(typeof body.sessionId === 'string' ? { sessionId: body.sessionId } : {}),
+            ...privateHostFetchOptions,
+        }), { status: 201 });
+    }
+    catch (error) {
+        return jsonErrorResponse(error, { status: 400 });
+    }
+}
+async function handleKnowledgeImportUrls(context, request) {
+    const admin = context.requireAdmin(request);
+    if (admin)
+        return admin;
+    const body = await context.parseJsonBody(request);
+    if (body instanceof Response)
+        return body;
+    const path = typeof body.path === 'string' ? body.path.trim() : '';
+    if (!path)
+        return Response.json({ error: 'Missing path' }, { status: 400 });
+    const privateHostFetchOptions = buildKnowledgePrivateHostFetchOptions(context, body.allowPrivateHosts);
+    if (privateHostFetchOptions instanceof Response)
+        return privateHostFetchOptions;
+    try {
+        return Response.json(await context.knowledgeService.importUrlsFromFile({
+            path,
+            ...(typeof body.sessionId === 'string' ? { sessionId: body.sessionId } : {}),
+            ...privateHostFetchOptions,
+        }), { status: 201 });
+    }
+    catch (error) {
+        return jsonErrorResponse(error, { status: 400 });
+    }
+}
+async function handleKnowledgeIngestConnector(context, request) {
+    const admin = context.requireAdmin(request);
+    if (admin)
+        return admin;
+    const body = await context.parseJsonBody(request);
+    if (body instanceof Response)
+        return body;
+    const connectorId = typeof body.connectorId === 'string' ? body.connectorId.trim() : '';
+    if (!connectorId)
+        return Response.json({ error: 'Missing connectorId' }, { status: 400 });
+    const privateHostFetchOptions = buildKnowledgePrivateHostFetchOptions(context, body.allowPrivateHosts);
+    if (privateHostFetchOptions instanceof Response)
+        return privateHostFetchOptions;
+    try {
+        return Response.json(await context.knowledgeService.ingestConnectorInput({
+            connectorId,
+            ...(Object.hasOwn(body, 'input') ? { input: body.input } : {}),
+            ...(typeof body.content === 'string' ? { content: body.content } : {}),
+            ...(typeof body.path === 'string' ? { path: body.path } : {}),
+            ...(typeof body.sessionId === 'string' ? { sessionId: body.sessionId } : {}),
+            ...privateHostFetchOptions,
+        }), { status: 201 });
+    }
+    catch (error) {
+        return jsonErrorResponse(error, { status: 400 });
+    }
+}
+async function handleKnowledgeSearch(context, request) {
+    const body = await context.parseJsonBody(request);
+    if (body instanceof Response)
+        return body;
+    const query = typeof body.query === 'string' ? body.query.trim() : '';
+    if (!query)
+        return Response.json({ error: 'Missing query' }, { status: 400 });
+    const limit = typeof body.limit === 'number' ? body.limit : 10;
+    return Response.json({ results: context.knowledgeService.search(query, limit) });
+}
+async function handleKnowledgePacket(context, request) {
+    const body = await context.parseJsonBody(request);
+    if (body instanceof Response)
+        return body;
+    const task = typeof body.task === 'string' ? body.task.trim() : '';
+    if (!task)
+        return Response.json({ error: 'Missing task' }, { status: 400 });
+    const writeScope = Array.isArray(body.writeScope) ? body.writeScope.filter((entry) => typeof entry === 'string') : [];
+    const limit = typeof body.limit === 'number' ? body.limit : 6;
+    const detail = typeof body.detail === 'string'
+        ? body.detail.toLowerCase()
+        : undefined;
+    const budgetLimit = typeof body.budgetLimit === 'number' ? body.budgetLimit : undefined;
+    return Response.json(await context.knowledgeService.buildPacket(task, writeScope, limit, {
+        ...(detail ? { detail } : {}),
+        ...(typeof budgetLimit === 'number' ? { budgetLimit } : {}),
+    }));
+}
+async function handleKnowledgeDecideCandidate(context, id, request) {
+    const admin = context.requireAdmin(request);
+    if (admin)
+        return admin;
+    const body = await context.parseJsonBody(request);
+    if (body instanceof Response)
+        return body;
+    const decision = typeof body.decision === 'string' ? body.decision.trim().toLowerCase() : '';
+    if (decision !== 'accept' && decision !== 'reject' && decision !== 'supersede') {
+        return Response.json({ error: 'Decision must be accept, reject, or supersede.' }, { status: 400 });
+    }
+    try {
+        return Response.json({
+            candidate: await context.knowledgeService.decideConsolidationCandidate(id, decision, {
+                ...(typeof body.decidedBy === 'string' ? { decidedBy: body.decidedBy } : {}),
+                ...(typeof body.memoryClass === 'string' ? { memoryClass: body.memoryClass } : {}),
+                ...(typeof body.scope === 'string' ? { scope: body.scope } : {}),
+                ...(typeof body.detail === 'string' ? { detail: body.detail } : {}),
+            }),
+        });
+    }
+    catch (error) {
+        const message = summarizeErrorForRecord(error);
+        return jsonErrorResponse(error, {
+            status: message.startsWith('Unknown knowledge consolidation candidate:') ? 404 : 400,
+        });
+    }
+}
+async function handleKnowledgeRunJob(context, jobId, request) {
+    const admin = context.requireAdmin(request);
+    if (admin)
+        return admin;
+    const body = await context.parseJsonBody(request);
+    if (body instanceof Response)
+        return body;
+    try {
+        return Response.json({
+            run: await context.knowledgeService.runJob(jobId, {
+                ...(typeof body.mode === 'string' ? { mode: body.mode.toLowerCase() } : {}),
+                ...(Array.isArray(body.sourceIds) ? { sourceIds: body.sourceIds.filter((entry) => typeof entry === 'string') } : {}),
+                ...(typeof body.limit === 'number' ? { limit: body.limit } : {}),
+            }),
+        });
+    }
+    catch (error) {
+        const message = summarizeErrorForRecord(error);
+        return jsonErrorResponse(error, {
+            status: message.startsWith('Unknown knowledge job:') ? 404 : 400,
+        });
+    }
+}
+async function handleKnowledgeSaveSchedule(context, request) {
+    const admin = context.requireAdmin(request);
+    if (admin)
+        return admin;
+    const body = await context.parseJsonBody(request);
+    if (body instanceof Response)
+        return body;
+    const jobId = typeof body.jobId === 'string' ? body.jobId.trim() : '';
+    if (!jobId)
+        return Response.json({ error: 'Missing jobId' }, { status: 400 });
+    const schedule = readKnowledgeSchedule(context, body.schedule);
+    if (schedule instanceof Response)
+        return schedule;
+    try {
+        return Response.json({
+            schedule: await context.knowledgeService.saveSchedule({
+                ...(typeof body.id === 'string' ? { id: body.id } : {}),
+                jobId,
+                schedule,
+                ...(typeof body.label === 'string' ? { label: body.label } : {}),
+                ...(typeof body.enabled === 'boolean' ? { enabled: body.enabled } : {}),
+                ...(typeof body.metadata === 'object' && body.metadata !== null ? { metadata: body.metadata } : {}),
+            }),
+        }, { status: 201 });
+    }
+    catch (error) {
+        return jsonErrorResponse(error, { status: 400 });
+    }
+}
+async function handleKnowledgeSetScheduleEnabled(context, id, request) {
+    const admin = context.requireAdmin(request);
+    if (admin)
+        return admin;
+    const body = await context.parseJsonBody(request);
+    if (body instanceof Response)
+        return body;
+    if (typeof body.enabled !== 'boolean') {
+        return Response.json({ error: 'Missing enabled boolean' }, { status: 400 });
+    }
+    const schedule = await context.knowledgeService.setScheduleEnabled(id, body.enabled);
+    return schedule
+        ? Response.json({ schedule })
+        : Response.json({ error: 'Unknown knowledge schedule' }, { status: 404 });
+}
+async function handleKnowledgeRenderProjection(context, request) {
+    const body = await context.parseJsonBody(request);
+    if (body instanceof Response)
+        return body;
+    const parsed = readKnowledgeProjectionRequest(body);
+    if (parsed instanceof Response)
+        return parsed;
+    try {
+        return Response.json(await context.knowledgeService.renderProjection(parsed));
+    }
+    catch (error) {
+        return jsonErrorResponse(error, { status: 400 });
+    }
+}
+async function handleKnowledgeMaterializeProjection(context, request) {
+    const admin = context.requireAdmin(request);
+    if (admin)
+        return admin;
+    const body = await context.parseJsonBody(request);
+    if (body instanceof Response)
+        return body;
+    const parsed = readKnowledgeProjectionRequest(body);
+    if (parsed instanceof Response)
+        return parsed;
+    try {
+        return Response.json(await context.knowledgeService.materializeProjection({
+            ...parsed,
+            ...(typeof body.filename === 'string' ? { filename: body.filename } : {}),
+        }), { status: 201 });
+    }
+    catch (error) {
+        return jsonErrorResponse(error, { status: 400 });
+    }
+}

package/dist/media-route-types.d.ts

@@ -0,0 +1,66 @@
+export type ArtifactKind = string;
+export type FetchExtractMode = string;
+export type MediaArtifact = Record<string, unknown>;
+export type MultimodalAnalysisResult = unknown;
+export type MultimodalDetail = string;
+export type VoiceAudioArtifact = Record<string, unknown>;
+export type WebSearchSafeSearch = string;
+export type WebSearchTimeRange = string;
+export type WebSearchVerbosity = string;
+export interface ConfigManagerLike {
+    get(key: string): unknown;
+}
+export interface VoiceServiceLike {
+    getStatus(enabled: boolean): Promise<{
+        providers: readonly unknown[];
+    }>;
+    listVoices(providerId?: string): Promise<readonly unknown[]>;
+    synthesize(providerId: string | undefined, input: Record<string, unknown>): Promise<unknown>;
+    transcribe(providerId: string | undefined, input: Record<string, unknown>): Promise<unknown>;
+    openRealtimeSession(providerId: string | undefined, input: Record<string, unknown>): Promise<unknown>;
+}
+export interface WebSearchServiceLike {
+    getStatus(): Promise<{
+        providers: readonly unknown[];
+    }>;
+    search(input: Record<string, unknown>): Promise<unknown>;
+}
+export interface ArtifactStoreLike {
+    list(): readonly unknown[];
+    create(input: Record<string, unknown>): Promise<unknown>;
+    get(artifactId: string): unknown | null;
+    readContent(artifactId: string): Promise<{
+        readonly record: {
+            readonly mimeType: string;
+            readonly filename?: string;
+        };
+        readonly buffer: ArrayBuffer | Uint8Array;
+    }>;
+}
+export interface MediaProviderLike {
+    analyze?(input: Record<string, unknown>): Promise<unknown>;
+    transform?(input: Record<string, unknown>): Promise<unknown>;
+    generate?(input: Record<string, unknown>): Promise<unknown>;
+}
+export interface MediaProviderRegistryLike {
+    status(): Promise<unknown>;
+    findProvider(capability: 'understand' | 'transform' | 'generate', providerId?: string): MediaProviderLike | null;
+}
+export interface MultimodalServiceLike {
+    getStatus(): Promise<unknown>;
+    listProviders(): Promise<readonly unknown[]>;
+    analyze(input: Record<string, unknown>): Promise<MultimodalAnalysisResult>;
+    buildPacket(analysis: MultimodalAnalysisResult, detail: MultimodalDetail, budgetLimit?: number): unknown;
+    writeBackAnalysis(analysis: MultimodalAnalysisResult, input: Record<string, unknown>): Promise<unknown>;
+}
+export interface DaemonMediaRouteContext {
+    readonly artifactStore: ArtifactStoreLike;
+    readonly configManager: ConfigManagerLike;
+    readonly mediaProviders: MediaProviderRegistryLike;
+    readonly multimodalService: MultimodalServiceLike;
+    readonly parseJsonBody: (req: Request) => Promise<Record<string, unknown> | Response>;
+    readonly requireAdmin: (req: Request) => Response | null;
+    readonly voiceService: VoiceServiceLike;
+    readonly webSearchService: WebSearchServiceLike;
+}
+//# sourceMappingURL=media-route-types.d.ts.map

package/dist/media-route-types.d.ts.map

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

package/dist/media-route-types.js

@@ -0,0 +1 @@
+export {};

package/dist/media-routes.d.ts

@@ -0,0 +1,4 @@
+import type { DaemonApiRouteHandlers } from './context.js';
+import type { DaemonMediaRouteContext } from './media-route-types.js';
+export declare function createDaemonMediaRouteHandlers(context: DaemonMediaRouteContext): Pick<DaemonApiRouteHandlers, 'getVoiceStatus' | 'getVoiceProviders' | 'getVoiceVoices' | 'postVoiceTts' | 'postVoiceStt' | 'postVoiceRealtimeSession' | 'getWebSearchProviders' | 'postWebSearch' | 'getArtifacts' | 'postArtifact' | 'getArtifact' | 'getArtifactContent' | 'getMediaProviders' | 'postMediaAnalyze' | 'postMediaTransform' | 'postMediaGenerate' | 'getMultimodalStatus' | 'getMultimodalProviders' | 'postMultimodalAnalyze' | 'postMultimodalPacket' | 'postMultimodalWriteback'>;
+//# sourceMappingURL=media-routes.d.ts.map

package/dist/media-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media-routes.d.ts","sourceRoot":"","sources":["../src/media-routes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAG3D,OAAO,KAAK,EAEV,uBAAuB,EASxB,MAAM,wBAAwB,CAAC;AAIhC,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,uBAAuB,GAC/B,IAAI,CACL,sBAAsB,EACpB,gBAAgB,GAChB,mBAAmB,GACnB,gBAAgB,GAChB,cAAc,GACd,cAAc,GACd,0BAA0B,GAC1B,uBAAuB,GACvB,eAAe,GACf,cAAc,GACd,cAAc,GACd,aAAa,GACb,oBAAoB,GACpB,mBAAmB,GACnB,kBAAkB,GAClB,oBAAoB,GACpB,mBAAmB,GACnB,qBAAqB,GACrB,wBAAwB,GACxB,uBAAuB,GACvB,sBAAsB,GACtB,yBAAyB,CAC5B,CA+BA"}