@kodax-ai/kodax 0.7.95 → 0.7.96-alpha.2

package/dist/builtin/skill-creator/scripts/quick-validate.d.ts

@@ -1,9 +1,9 @@
-export interface SkillValidationResult {
-  valid: boolean;
-  errors: string[];
-  warnings: string[];
-  frontmatter: Record<string, unknown> | null;
-}
-
-export function validateSkillDirectory(skillDir: string): Promise<SkillValidationResult>;
+export interface SkillValidationResult {
+  valid: boolean;
+  errors: string[];
+  warnings: string[];
+  frontmatter: Record<string, unknown> | null;
+}
+
+export function validateSkillDirectory(skillDir: string): Promise<SkillValidationResult>;
 export declare function main(argv?: string[]): Promise<void>;

package/dist/builtin/skill-creator/scripts/quick-validate.js

@@ -1,167 +1,167 @@
-#!/usr/bin/env node
-
-import path from 'node:path';
-import { fileURLToPath } from 'node:url';
-import { loadSkill } from './utils.js';
-
-const ALLOWED_FRONTMATTER_KEYS = new Set([
-  'name',
-  'description',
-  'license',
-  'compatibility',
-  'metadata',
-  'allowed-tools',
-  'disable-model-invocation',
-  'user-invocable',
-  'argument-hint',
-  'context',
-  'agent',
-  'model',
-  'hooks',
-]);
-
-export async function validateSkillDirectory(skillDir) {
-  const result = {
-    valid: false,
-    errors: [],
-    warnings: [],
-    frontmatter: null,
-  };
-
-  let skill;
-  try {
-    skill = await loadSkill(skillDir);
-  } catch (error) {
-    result.errors.push(error instanceof Error ? error.message : String(error));
-    return result;
-  }
-
-  const { frontmatter, body } = skill;
-  result.frontmatter = frontmatter;
-
-  const unexpectedKeys = Object.keys(frontmatter).filter((key) => !ALLOWED_FRONTMATTER_KEYS.has(key));
-  if (unexpectedKeys.length > 0) {
-    result.errors.push(
-      `Unexpected frontmatter keys: ${unexpectedKeys.sort().join(', ')}`
-    );
-  }
-
-  const name = typeof frontmatter.name === 'string' ? frontmatter.name.trim() : '';
-  const description = typeof frontmatter.description === 'string'
-    ? frontmatter.description.trim()
-    : '';
-
-  if (!name) {
-    result.errors.push('Missing required frontmatter field: name');
-  } else {
-    if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(name)) {
-      result.errors.push(
-        `Invalid skill name "${name}". Use lowercase kebab-case and avoid consecutive hyphens.`
-      );
-    }
-    if (name.length > 64) {
-      result.errors.push(`Skill name is too long (${name.length}/64).`);
-    }
-
-    const dirName = path.basename(path.resolve(skillDir));
-    if (dirName !== name) {
-      result.warnings.push(
-        `Skill directory name "${dirName}" does not match frontmatter name "${name}".`
-      );
-    }
-  }
-
-  if (!description) {
-    result.errors.push('Missing required frontmatter field: description');
-  } else {
-    if (description.length > 1024) {
-      result.errors.push(`Description is too long (${description.length}/1024).`);
-    }
-    if (/[<>]/.test(description)) {
-      result.errors.push('Description cannot contain angle brackets.');
-    }
-    if (!/[。.!?]/.test(description)) {
-      result.warnings.push('Description may be too terse; consider making the trigger conditions clearer.');
-    }
-  }
-
-  if (!body.trim()) {
-    result.errors.push('SKILL.md body is empty.');
-  }
-
-  if (frontmatter.compatibility != null) {
-    if (typeof frontmatter.compatibility !== 'string') {
-      result.errors.push('compatibility must be a string if provided.');
-    } else if (frontmatter.compatibility.length > 500) {
-      result.errors.push(`compatibility is too long (${frontmatter.compatibility.length}/500).`);
-    }
-  }
-
-  if (frontmatter['allowed-tools'] != null) {
-    const allowedTools = frontmatter['allowed-tools'];
-    const validAllowedTools = typeof allowedTools === 'string'
-      || (Array.isArray(allowedTools) && allowedTools.every((item) => typeof item === 'string'));
-    if (!validAllowedTools) {
-      result.errors.push('allowed-tools must be a string or string array.');
-    }
-  }
-
-  if (frontmatter['disable-model-invocation'] != null
-      && typeof frontmatter['disable-model-invocation'] !== 'boolean') {
-    result.errors.push('disable-model-invocation must be a boolean.');
-  }
-
-  if (frontmatter['user-invocable'] != null && typeof frontmatter['user-invocable'] !== 'boolean') {
-    result.errors.push('user-invocable must be a boolean.');
-  }
-
-  if (frontmatter.context != null && frontmatter.context !== 'fork') {
-    result.errors.push('context must be "fork" when provided.');
-  }
-
-  if (frontmatter.hooks != null && (typeof frontmatter.hooks !== 'object' || Array.isArray(frontmatter.hooks))) {
-    result.errors.push('hooks must be an object when provided.');
-  }
-
-  result.valid = result.errors.length === 0;
-  return result;
-}
-
+#!/usr/bin/env node
+
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { loadSkill } from './utils.js';
+
+const ALLOWED_FRONTMATTER_KEYS = new Set([
+  'name',
+  'description',
+  'license',
+  'compatibility',
+  'metadata',
+  'allowed-tools',
+  'disable-model-invocation',
+  'user-invocable',
+  'argument-hint',
+  'context',
+  'agent',
+  'model',
+  'hooks',
+]);
+
+export async function validateSkillDirectory(skillDir) {
+  const result = {
+    valid: false,
+    errors: [],
+    warnings: [],
+    frontmatter: null,
+  };
+
+  let skill;
+  try {
+    skill = await loadSkill(skillDir);
+  } catch (error) {
+    result.errors.push(error instanceof Error ? error.message : String(error));
+    return result;
+  }
+
+  const { frontmatter, body } = skill;
+  result.frontmatter = frontmatter;
+
+  const unexpectedKeys = Object.keys(frontmatter).filter((key) => !ALLOWED_FRONTMATTER_KEYS.has(key));
+  if (unexpectedKeys.length > 0) {
+    result.errors.push(
+      `Unexpected frontmatter keys: ${unexpectedKeys.sort().join(', ')}`
+    );
+  }
+
+  const name = typeof frontmatter.name === 'string' ? frontmatter.name.trim() : '';
+  const description = typeof frontmatter.description === 'string'
+    ? frontmatter.description.trim()
+    : '';
+
+  if (!name) {
+    result.errors.push('Missing required frontmatter field: name');
+  } else {
+    if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(name)) {
+      result.errors.push(
+        `Invalid skill name "${name}". Use lowercase kebab-case and avoid consecutive hyphens.`
+      );
+    }
+    if (name.length > 64) {
+      result.errors.push(`Skill name is too long (${name.length}/64).`);
+    }
+
+    const dirName = path.basename(path.resolve(skillDir));
+    if (dirName !== name) {
+      result.warnings.push(
+        `Skill directory name "${dirName}" does not match frontmatter name "${name}".`
+      );
+    }
+  }
+
+  if (!description) {
+    result.errors.push('Missing required frontmatter field: description');
+  } else {
+    if (description.length > 1024) {
+      result.errors.push(`Description is too long (${description.length}/1024).`);
+    }
+    if (/[<>]/.test(description)) {
+      result.errors.push('Description cannot contain angle brackets.');
+    }
+    if (!/[。.!?]/.test(description)) {
+      result.warnings.push('Description may be too terse; consider making the trigger conditions clearer.');
+    }
+  }
+
+  if (!body.trim()) {
+    result.errors.push('SKILL.md body is empty.');
+  }
+
+  if (frontmatter.compatibility != null) {
+    if (typeof frontmatter.compatibility !== 'string') {
+      result.errors.push('compatibility must be a string if provided.');
+    } else if (frontmatter.compatibility.length > 500) {
+      result.errors.push(`compatibility is too long (${frontmatter.compatibility.length}/500).`);
+    }
+  }
+
+  if (frontmatter['allowed-tools'] != null) {
+    const allowedTools = frontmatter['allowed-tools'];
+    const validAllowedTools = typeof allowedTools === 'string'
+      || (Array.isArray(allowedTools) && allowedTools.every((item) => typeof item === 'string'));
+    if (!validAllowedTools) {
+      result.errors.push('allowed-tools must be a string or string array.');
+    }
+  }
+
+  if (frontmatter['disable-model-invocation'] != null
+      && typeof frontmatter['disable-model-invocation'] !== 'boolean') {
+    result.errors.push('disable-model-invocation must be a boolean.');
+  }
+
+  if (frontmatter['user-invocable'] != null && typeof frontmatter['user-invocable'] !== 'boolean') {
+    result.errors.push('user-invocable must be a boolean.');
+  }
+
+  if (frontmatter.context != null && frontmatter.context !== 'fork') {
+    result.errors.push('context must be "fork" when provided.');
+  }
+
+  if (frontmatter.hooks != null && (typeof frontmatter.hooks !== 'object' || Array.isArray(frontmatter.hooks))) {
+    result.errors.push('hooks must be an object when provided.');
+  }
+
+  result.valid = result.errors.length === 0;
+  return result;
+}
+
 export async function main(argv = process.argv) {
   const skillDir = argv[2];
-  if (!skillDir) {
-    console.error('Usage: node scripts/quick-validate.js <skill-directory>');
-    process.exit(1);
-  }
-
-  const result = await validateSkillDirectory(skillDir);
-
-  if (result.errors.length === 0) {
-    console.log('Skill is valid.');
-  } else {
-    console.error('Skill validation failed:');
-    for (const error of result.errors) {
-      console.error(`- ${error}`);
-    }
-  }
-
-  if (result.warnings.length > 0) {
-    console.log('Warnings:');
-    for (const warning of result.warnings) {
-      console.log(`- ${warning}`);
-    }
-  }
-
-  process.exit(result.valid ? 0 : 1);
-}
-
+  if (!skillDir) {
+    console.error('Usage: node scripts/quick-validate.js <skill-directory>');
+    process.exit(1);
+  }
+
+  const result = await validateSkillDirectory(skillDir);
+
+  if (result.errors.length === 0) {
+    console.log('Skill is valid.');
+  } else {
+    console.error('Skill validation failed:');
+    for (const error of result.errors) {
+      console.error(`- ${error}`);
+    }
+  }
+
+  if (result.warnings.length > 0) {
+    console.log('Warnings:');
+    for (const warning of result.warnings) {
+      console.log(`- ${warning}`);
+    }
+  }
+
+  process.exit(result.valid ? 0 : 1);
+}
+
 const isDirectRun = process.env.KODAX_MODULE_BUNDLE !== 'true'
   && process.argv[1]
-  && fileURLToPath(import.meta.url) === path.resolve(process.argv[1]);
-
-if (isDirectRun) {
-  main().catch((error) => {
-    console.error(error instanceof Error ? error.message : String(error));
-    process.exit(1);
-  });
-}
+  && fileURLToPath(import.meta.url) === path.resolve(process.argv[1]);
+
+if (isDirectRun) {
+  main().catch((error) => {
+    console.error(error instanceof Error ? error.message : String(error));
+    process.exit(1);
+  });
+}

package/dist/builtin/skill-creator/scripts/run-eval.d.ts

@@ -1,67 +1,67 @@
-export interface SkillEvalAssertion {
-  text: string;
-}
-
-export interface SkillEvalItem {
-  id?: string | number;
-  name?: string;
-  prompt?: string;
-  query?: string;
-  expected_output?: string;
-  files?: string[];
-  assertions?: Array<string | SkillEvalAssertion>;
-}
-
-export interface SkillEvalExecution {
-  result: {
-    success: boolean;
-    lastText: string;
-    signal?: 'COMPLETE' | 'BLOCKED' | 'DECIDE';
-    signalReason?: string;
-    messages: Array<Record<string, unknown>>;
-    sessionId: string;
-    interrupted?: boolean;
-    limitReached?: boolean;
-  };
-  totalTokens: number;
-  durationMs: number;
-}
-
-export interface RunEvalWorkspaceOptions {
-  skillPath: string;
-  evalsPath: string;
-  workspaceDir: string;
-  provider?: string;
-  model?: string;
-  runsPerConfig?: number;
-  maxIter?: number;
-  reasoningMode?: string;
-  cwd?: string;
-  configs?: string[];
-  output?: string;
-}
-
-export function buildEvalPrompt(
-  evalItem: SkillEvalItem,
-  options: Pick<RunEvalWorkspaceOptions, 'evalsPath' | 'cwd'>
-): Promise<string>;
-
-export function runEvalWorkspace(
-  options: RunEvalWorkspaceOptions,
-  runner?: (
-    prompt: string,
-    options: RunEvalWorkspaceOptions & {
-      configName: string;
-      evalItem: SkillEvalItem;
-      runIndex: number;
-    }
-  ) => Promise<SkillEvalExecution>
-): Promise<{
-  workspace: string;
-  skill_name: string;
-  eval_count: number;
-  configs: string[];
-  runs_per_config: number;
-  reports: Array<Record<string, unknown>>;
-}>;
+export interface SkillEvalAssertion {
+  text: string;
+}
+
+export interface SkillEvalItem {
+  id?: string | number;
+  name?: string;
+  prompt?: string;
+  query?: string;
+  expected_output?: string;
+  files?: string[];
+  assertions?: Array<string | SkillEvalAssertion>;
+}
+
+export interface SkillEvalExecution {
+  result: {
+    success: boolean;
+    lastText: string;
+    signal?: 'COMPLETE' | 'BLOCKED' | 'DECIDE';
+    signalReason?: string;
+    messages: Array<Record<string, unknown>>;
+    sessionId: string;
+    interrupted?: boolean;
+    limitReached?: boolean;
+  };
+  totalTokens: number;
+  durationMs: number;
+}
+
+export interface RunEvalWorkspaceOptions {
+  skillPath: string;
+  evalsPath: string;
+  workspaceDir: string;
+  provider?: string;
+  model?: string;
+  runsPerConfig?: number;
+  maxIter?: number;
+  reasoningMode?: string;
+  cwd?: string;
+  configs?: string[];
+  output?: string;
+}
+
+export function buildEvalPrompt(
+  evalItem: SkillEvalItem,
+  options: Pick<RunEvalWorkspaceOptions, 'evalsPath' | 'cwd'>
+): Promise<string>;
+
+export function runEvalWorkspace(
+  options: RunEvalWorkspaceOptions,
+  runner?: (
+    prompt: string,
+    options: RunEvalWorkspaceOptions & {
+      configName: string;
+      evalItem: SkillEvalItem;
+      runIndex: number;
+    }
+  ) => Promise<SkillEvalExecution>
+): Promise<{
+  workspace: string;
+  skill_name: string;
+  eval_count: number;
+  configs: string[];
+  runs_per_config: number;
+  reports: Array<Record<string, unknown>>;
+}>;
 export declare function main(argv?: string[]): Promise<void>;