Beautiful, AI-native markdown IDE and LLM wiki
TypeScript 2nd-brainagent-skillsclaudecodexcompany-braindocsknowledge-knowledge-baseknowledge-managementllmllm-wikillm-wiki-karpathymarkdownmarkdown-editormdmdxnotespkmsecond-brainskills
import type { IncomingMessage, ServerResponse } from 'node:http';
import {
SeedApplyRequestSchema,
SeedApplySuccessSchema,
SeedInstallPackSkillRequestSchema,
SeedInstallPackSkillSuccessSchema,
SeedListPacksSuccessSchema,
SeedPlanSuccessSchema,
} from '@inkeep/open-knowledge-core';
import {
applySeed,
coercePackId,
installPackSkillOnDemand,
listStarterPacks,
planSeed,
type ScaffoldPlan,
SeedPrerequisiteError,
SeedRootDirError,
} from '../seed/index.ts';
import { type ApiRouteGroup, createApiRouteGroup } from './api-pipeline.ts';
import { errorResponse } from './error-response.ts';
import { withValidation } from './request-validation.ts';
import { successResponse } from './success-response.ts';
export interface SeedRouteDeps {
contentDir: string;
checkLocalOpSecurity: (
req: IncomingMessage,
res: ServerResponse,
opts: { handler: string },
) => boolean;
}
export function createSeedRoutes(deps: SeedRouteDeps): ApiRouteGroup {
const { contentDir, checkLocalOpSecurity } = deps;
async function handleSeedPlan(req: IncomingMessage, res: ServerResponse): Promise<void> {
if (!checkLocalOpSecurity(req, res, { handler: 'seed-plan' })) return;
if (req.method !== 'GET') {
errorResponse(res, 405, 'urn:ok:error:method-not-allowed', 'Method not allowed.', {
handler: 'seed-plan',
extraHeaders: { Allow: 'GET' },
});
return;
}
const url = new URL(req.url ?? '/', 'http://localhost');
const rootDir = url.searchParams.get('rootDir') ?? undefined;
const rawPackId = url.searchParams.get('packId');
const packId = coercePackId(rawPackId);
if (rawPackId !== null && rawPackId !== '' && packId === undefined) {
errorResponse(res, 400, 'urn:ok:error:invalid-request', 'Unknown packId.', {
handler: 'seed-plan',
detail: `Pack id "${rawPackId}" is not registered.`,
});
return;
}
try {
const plan = await planSeed({ projectDir: contentDir, rootDir, packId });
successResponse(res, 200, SeedPlanSuccessSchema, { plan }, { handler: 'seed-plan' });
} catch (err) {
if (err instanceof SeedPrerequisiteError) {
errorResponse(
res,
422,
'urn:ok:error:seed-prerequisite-missing',
'Seed prerequisite missing.',
{ handler: 'seed-plan', cause: err },
);
return;
}
if (err instanceof SeedRootDirError) {
errorResponse(res, 400, 'urn:ok:error:seed-invalid-root', 'Invalid seed root directory.', {
handler: 'seed-plan',
detail: 'The provided root directory is not within the workspace content directory.',
cause: err,
});
return;
}
errorResponse(res, 500, 'urn:ok:error:internal-server-error', 'Internal server error.', {
handler: 'seed-plan',
cause: err,
});
}
}
const handleSeedApply = withValidation(
SeedApplyRequestSchema,
async (_req, res, body) => {
const planValue = body.plan;
if (!planValue || typeof planValue !== 'object') {
errorResponse(res, 400, 'urn:ok:error:invalid-request', 'Invalid plan payload.', {
handler: 'seed-apply',
});
return;
}
const plan = planValue as ScaffoldPlan;
const looseBody = body as { packId?: unknown };
const rawPackId = looseBody.packId;
const packId = coercePackId(rawPackId);
if (typeof rawPackId === 'string' && rawPackId.length > 0 && packId === undefined) {
errorResponse(res, 400, 'urn:ok:error:invalid-request', 'Unknown packId.', {
handler: 'seed-apply',
detail: `Pack id "${rawPackId}" is not registered.`,
});
return;
}
try {
const result = await applySeed(plan, { projectDir: contentDir, packId });
successResponse(res, 200, SeedApplySuccessSchema, { result }, { handler: 'seed-apply' });
} catch (err) {
errorResponse(
res,
500,
'urn:ok:error:internal-server-error',
'Failed to apply seed plan.',
{
handler: 'seed-apply',
cause: err,
},
);
}
},
{
handler: 'seed-apply',
method: 'POST',
preBodyGate: (req, res) => checkLocalOpSecurity(req, res, { handler: 'seed-apply' }),
},
);
const handleSeedInstallPackSkill = withValidation(
SeedInstallPackSkillRequestSchema,
async (_req, res, body) => {
const packId = coercePackId(body.packId);
if (packId === undefined) {
errorResponse(res, 400, 'urn:ok:error:invalid-request', 'Unknown packId.', {
handler: 'seed-install-pack-skill',
detail: `Pack id "${body.packId}" is not registered.`,
});
return;
}
try {
const result = await installPackSkillOnDemand(contentDir, packId);
successResponse(res, 200, SeedInstallPackSkillSuccessSchema, result, {
handler: 'seed-install-pack-skill',
});
} catch (err) {
errorResponse(
res,
500,
'urn:ok:error:internal-server-error',
'Failed to install pack skill.',
{ handler: 'seed-install-pack-skill', cause: err },
);
}
},
{
handler: 'seed-install-pack-skill',
method: 'POST',
preBodyGate: (req, res) =>
checkLocalOpSecurity(req, res, { handler: 'seed-install-pack-skill' }),
},
);
async function handleSeedPacks(req: IncomingMessage, res: ServerResponse): Promise<void> {
if (!checkLocalOpSecurity(req, res, { handler: 'seed-packs' })) return;
if (req.method !== 'GET') {
errorResponse(res, 405, 'urn:ok:error:method-not-allowed', 'Method not allowed.', {
handler: 'seed-packs',
extraHeaders: { Allow: 'GET' },
});
return;
}
successResponse(
res,
200,
SeedListPacksSuccessSchema,
{ packs: listStarterPacks() },
{ handler: 'seed-packs' },
);
}
return createApiRouteGroup(
{
'/api/seed/plan': handleSeedPlan,
'/api/seed/apply': handleSeedApply,
'/api/seed/install-pack-skill': handleSeedInstallPackSkill,
'/api/seed/packs': handleSeedPacks,
},
{ mutating: ['/api/seed/apply', '/api/seed/install-pack-skill'] },
);
}