Elydora-Node-SDK/test-support/kimi-test-helpers.mjs

import assert from 'node:assert/strict';
import { spawn } from 'node:child_process';
import { mkdir, mkdtemp, rm, writeFile } from 'node:fs/promises';
import http from 'node:http';
import os from 'node:os';
import path from 'node:path';
import { pathToFileURL } from 'node:url';
import { parse as parseToml } from '@decimalturn/toml-patch';

export const VALID_PRIVATE_KEY = Buffer.alloc(32).toString('base64url');
export const pluginModuleUrl = pathToFileURL(path.resolve('dist/plugins/kimi.js')).href;
export const registryModuleUrl = pathToFileURL(path.resolve('dist/plugins/registry.js')).href;
export const contractModuleUrl = pathToFileURL(path.resolve('dist/plugins/kimi-contract.js')).href;
export const ioModuleUrl = pathToFileURL(path.resolve('dist/plugins/kimi-io.js')).href;
export const installationModuleUrl = pathToFileURL(
  path.resolve('dist/plugins/kimi-installation.js'),
).href;
export const cliPath = path.resolve('dist/cli.js');

export function runNode(args, env, cwd, input = '', unset = []) {
  return new Promise((resolve, reject) => {
    const childEnv = { ...process.env, ...env };
    for (const key of unset) delete childEnv[key];
    const child = spawn(process.execPath, args, {
      cwd,
      env: childEnv,
      stdio: ['pipe', 'pipe', 'pipe'],
    });
    let stdout = '';
    let stderr = '';
    child.stdout.on('data', (chunk) => { stdout += chunk; });
    child.stderr.on('data', (chunk) => { stderr += chunk; });
    child.once('error', reject);
    child.once('close', (code) => resolve({ code, stdout, stderr }));
    child.stdin.end(input);
  });
}

export function runKimiHook(command, input, fixture, environment = {}) {
  return new Promise((resolve, reject) => {
    const child = spawn(command, {
      shell: true,
      cwd: fixture.projectDir,
      env: {
        ...process.env,
        HOME: fixture.homeDir,
        USERPROFILE: fixture.homeDir,
        KIMI_CODE_HOME: fixture.kimiHomeOverride ?? '',
        ...environment,
      },
      stdio: ['pipe', 'pipe', 'pipe'],
    });
    let stdout = '';
    let stderr = '';
    child.stdout.on('data', (chunk) => { stdout += chunk; });
    child.stderr.on('data', (chunk) => { stderr += chunk; });
    child.once('error', reject);
    child.once('close', (code) => resolve({ code, stdout, stderr }));
    child.stdin.end(input);
  });
}

export function installConfig(fixture, overrides = {}) {
  return {
    agentName: 'kimi',
    orgId: 'org-1',
    agentId: 'agent-1',
    privateKey: VALID_PRIVATE_KEY,
    kid: 'kid-1',
    token: 'token-1',
    baseUrl: fixture.baseUrl,
    guardScriptPath: fixture.guardScriptPath,
    hookScriptPath: fixture.hookScriptPath,
    ...overrides,
  };
}

export async function runPlugin(fixture, method, argument, environment = {}) {
  const source = `
    import { kimiPlugin } from ${JSON.stringify(pluginModuleUrl)};
    const argument = JSON.parse(process.env.ELYDORA_TEST_ARGUMENT);
    const result = await kimiPlugin[process.env.ELYDORA_TEST_METHOD](argument);
    if (result !== undefined) console.log(JSON.stringify(result));
  `;
  const env = {
    HOME: fixture.homeDir,
    USERPROFILE: fixture.homeDir,
    ELYDORA_TEST_ARGUMENT: JSON.stringify(argument),
    ELYDORA_TEST_METHOD: method,
    ...environment,
  };
  const unset = [];
  if (fixture.kimiHomeOverride === undefined) unset.push('KIMI_CODE_HOME');
  else env.KIMI_CODE_HOME = fixture.kimiHomeOverride;
  return runNode(
    ['--input-type=module', '--eval', source],
    env,
    fixture.projectDir,
    '',
    unset,
  );
}

async function writeOptional(filePath, contents) {
  if (contents === undefined) return;
  await mkdir(path.dirname(filePath), { recursive: true });
  await writeFile(filePath, contents, { encoding: 'utf-8', mode: 0o600 });
}

export async function createFixture({
  baseUrl = 'http://127.0.0.1:9',
  stableConfig,
  legacyConfig,
  stableDetected = true,
  legacyDetected = true,
  explicitKimiHome = true,
} = {}) {
  const rootDir = await mkdtemp(path.join(os.tmpdir(), 'elydora-kimi-'));
  const homeDir = path.join(rootDir, "home with spaces and 'quote %ELYDORA_HOOK_PATH%");
  const projectDir = path.join(rootDir, 'project with spaces');
  const kimiHome = explicitKimiHome
    ? path.join(homeDir, 'custom kimi-code')
    : path.join(homeDir, '.kimi-code');
  const stablePath = path.join(kimiHome, 'config.toml');
  const legacyHome = path.join(homeDir, '.kimi');
  const legacyPath = path.join(legacyHome, 'config.toml');
  const agentDir = path.join(homeDir, '.elydora', 'agent-1');
  const guardScriptPath = path.join(agentDir, 'guard.js');
  const hookScriptPath = path.join(agentDir, 'hook.js');
  await mkdir(projectDir, { recursive: true });
  if (stableDetected && !explicitKimiHome) await mkdir(kimiHome, { recursive: true });
  if (legacyDetected) await mkdir(legacyHome, { recursive: true });
  await writeOptional(stablePath, stableConfig);
  await writeOptional(legacyPath, legacyConfig);
  const fixture = {
    agentDir,
    baseUrl,
    guardScriptPath,
    homeDir,
    hookScriptPath,
    kimiHome,
    kimiHomeOverride: explicitKimiHome ? kimiHome : undefined,
    legacyHome,
    legacyPath,
    projectDir,
    rootDir,
    stablePath,
    install(overrides = {}) {
      return runPlugin(this, 'install', installConfig(this, overrides));
    },
    async close() {
      await rm(rootDir, { recursive: true, force: true });
    },
  };
  return fixture;
}

export function readKimiConfig(filePath) {
  return import('node:fs/promises')
    .then(({ readFile }) => readFile(filePath, 'utf-8'))
    .then((raw) => ({ raw, config: parseToml(raw) }));
}

export function managedHook(config, event) {
  return config.hooks?.findLast((hook) => hook.event === event && hook.timeout === 10);
}

export function assertManagedHook(hook, event) {
  assert(hook);
  assert.deepEqual(Object.keys(hook).sort(), ['command', 'event', 'timeout']);
  assert.equal(hook.event, event);
  assert.equal(hook.timeout, 10);
  if (process.platform === 'win32') {
    assert.match(hook.command, /^"[^"\r\n]+powershell\.exe" .* -EncodedCommand /i);
  } else {
    assert.match(hook.command, /^'[^']*node[^']*' /i);
  }
}

export function legacyCommand(scriptPath) {
  if (process.platform === 'win32') return `"${process.execPath}" "${scriptPath}"`;
  const quote = (value) => `'${value.replaceAll("'", `'"'"'`)}'`;
  return `${quote(process.execPath)} ${quote(scriptPath)}`;
}

export async function startApiServer({ status = 'active', operationStatus = 201 } = {}) {
  const requests = [];
  const server = http.createServer(async (request, response) => {
    const chunks = [];
    for await (const chunk of request) chunks.push(chunk);
    const raw = Buffer.concat(chunks).toString('utf-8');
    requests.push({
      headers: request.headers,
      method: request.method,
      url: request.url,
      raw,
    });
    if (request.method === 'GET') {
      response.writeHead(200, { 'Content-Type': 'application/json' });
      response.end(JSON.stringify({ agent: { status } }));
      return;
    }
    response.writeHead(operationStatus, { 'Content-Type': 'application/json' });
    response.end(operationStatus >= 200 && operationStatus < 300
      ? JSON.stringify({ operation: { accepted: true } })
      : JSON.stringify({ error: { code: 'UPSTREAM_FAILURE', message: 'failed' } }));
  });
  await new Promise((resolve, reject) => {
    server.once('error', reject);
    server.listen(0, '127.0.0.1', resolve);
  });
  const address = server.address();
  return {
    baseUrl: `http://127.0.0.1:${address.port}`,
    requests,
    close: () => new Promise((resolve, reject) => {
      server.close((error) => error ? reject(error) : resolve());
    }),
  };
}