CtrlK
BlogDocsLog inGet started
Tessl Logo

jbaruch/koog

Koog 1.0 idioms, gotchas, and scaffolding skills for Kotlin agents on the JVM

88

1.95x
Quality

88%

Does it follow best practices?

Impact

88%

1.95x

Average score across 43 eval scenarios

SecuritybySnyk

Passed

No known issues

Overview
Quality
Evals
Security
Files

criteria.jsonevals/scenario-30/

{
  "context": "Tests whether the migration correctly identifies every breaking change visible in the 0.x snippet — the AgentMemory removal, the AIAgent.invoke factory shift, the LongTermMemory renames, the JDK bump, and adds the new dependency module — rather than just doing a single line change and missing the cascade.",
  "type": "weighted_checklist",
  "checklist": [
    {
      "name": "Replaces AgentMemory with LongTermMemory",
      "description": "Removes the install(AgentMemory) call and replaces with install(LongTermMemory) — AgentMemory was removed in 1.0. Does not leave install(AgentMemory) intact or comment it out without a replacement",
      "max_score": 25
    },
    {
      "name": "Renames queryExtractor and extractionStrategy",
      "description": "Renames queryExtractor → searchQueryProvider and extractionStrategy → documentExtractor inside the install block. The corresponding type references update accordingly",
      "max_score": 15
    },
    {
      "name": "Removes IngestionTiming",
      "description": "Removes the ingestionTiming = ... line — IngestionTiming was removed in 1.0; strategies now manage ingestion timing internally. Does not leave the dead reference",
      "max_score": 10
    },
    {
      "name": "Drops .invoke from the AIAgent call",
      "description": "Changes AIAgent.invoke(...) to AIAgent(...) — the companion invoke was removed in 1.0; the top-level factory has the same call site. Does not leave AIAgent.invoke or substitute concrete subtype constructors",
      "max_score": 15
    },
    {
      "name": "Adds the new LongTermMemory dependency",
      "description": "Adds ai.koog:agents-features-longterm-memory at 1.0.0+ to the build (and the AWS backend module if using Bedrock). The umbrella koog-agents does not include this feature",
      "max_score": 15
    },
    {
      "name": "Bumps JDK target to 17",
      "description": "Updates the JVM toolchain to 17 — Koog 1.0 requires JDK 17 minimum. The current JDK 11 target compiles against 0.x but fails against 1.0",
      "max_score": 10
    },
    {
      "name": "Updates all Koog coordinates to 1.0+",
      "description": "Bumps every ai.koog:* artifact in build.gradle.kts to 1.0.0 or later. Does not leave any artifact at the 0.7.x version",
      "max_score": 10
    }
  ]
}

evals

README.md

tile.json