kradle 0.6.8 → 0.6.10

package/README.md

@@ -226,13 +226,11 @@ Get details and logs for a specific run:
 ```bash
 kradle challenge runs get <run-id>
 kradle challenge runs get <run-id> --no-logs      # Skip fetching logs
-kradle challenge runs get <run-id> --no-summary   # Skip AI summary
 ```
 
 This displays:
 - Run metadata (status, duration, end state)
 - Participant results (agent, winner status, score)
-- AI-generated summary (unless `--no-summary` is used)
 - Log entries with timestamps and levels (unless `--no-logs` is used)
 
 ## Experiment Commands
@@ -407,7 +405,7 @@ Locations are synced to the cloud when you push the world.
 
 ### List Agents
 
-List all agents registered in the system:
+List all agents registered in the system with their model and pricing information (input/output cost per million tokens):
 
 ```bash
 kradle agent list
@@ -415,7 +413,7 @@ kradle agent list
 
 ## AI Docs Commands
 
-Output LLM-focused documentation to stdout. These commands are designed to provide AI agents with comprehensive reference material about the Kradle CLI and API.
+Output LLM-focused documentation to stdout, or sync local AI docs with the latest version from the CLI.
 
 ### CLI Reference
 
@@ -436,6 +434,19 @@ kradle ai-docs challenges-sdk 0.2.1        # Uses specific version
 
 This fetches the documentation from unpkg.com, matching the SDK version in your project.
 
+### Sync AI Docs
+
+Sync project AI docs (`AGENTS.md`, `CLAUDE.md`) to the latest version bundled with the CLI:
+
+```bash
+kradle ai-docs sync                        # Interactive confirmation
+kradle ai-docs sync --dry-run              # Preview changes without applying
+kradle ai-docs sync --yes                  # Skip confirmation prompts
+kradle ai-docs sync --add-missing          # Also create files missing locally
+```
+
+This compares your local `AGENTS.md` and `CLAUDE.md` against the templates bundled with the installed CLI version. Useful after upgrading `kradle` to pick up new AI doc templates.
+
 ## Publishing a New Version
 
 The CLI uses GitHub Actions for automated releases. To publish a new version:

package/dist/commands/agent/list.js

@@ -2,6 +2,49 @@ import { Command } from "@oclif/core";
 import pc from "picocolors";
 import { ApiClient } from "../../lib/api-client.js";
 import { getConfigFlags } from "../../lib/flags.js";
+async function fetchOpenRouterPricing() {
+    const pricing = new Map();
+    try {
+        const response = await fetch("https://openrouter.ai/api/v1/models", {
+            signal: AbortSignal.timeout(5000),
+        });
+        if (!response.ok)
+            return pricing;
+        const data = (await response.json());
+        for (const model of data.data) {
+            const promptCost = Number.parseFloat(model.pricing.prompt);
+            const completionCost = Number.parseFloat(model.pricing.completion);
+            if (!Number.isNaN(promptCost) && !Number.isNaN(completionCost) && promptCost >= 0 && completionCost >= 0) {
+                pricing.set(model.id, {
+                    input: promptCost * 1_000_000,
+                    output: completionCost * 1_000_000,
+                });
+            }
+        }
+    }
+    catch {
+        // Silently fail - pricing is best-effort
+    }
+    return pricing;
+}
+function formatCost(cost) {
+    if (cost === 0)
+        return "$0";
+    if (cost < 0.01)
+        return `$${cost.toFixed(4)}`;
+    return `$${cost.toFixed(2)}`;
+}
+function colorizeCost(formatted, cost) {
+    if (cost === undefined)
+        return pc.dim("-");
+    if (cost < 1)
+        return pc.green(formatted);
+    if (cost < 5)
+        return pc.cyan(formatted);
+    if (cost < 15)
+        return pc.yellow(formatted);
+    return pc.red(formatted);
+}
 export default class List extends Command {
     static description = "List all agents";
     static examples = ["<%= config.bin %> <%= command.id %>"];
@@ -12,11 +55,33 @@ export default class List extends Command {
         const { flags } = await this.parse(List);
         const api = new ApiClient(flags["api-url"], flags["api-key"]);
         this.log(pc.blue(">> Loading agents..."));
-        const agents = await api.listKradleAgents();
+        const [agents, pricing] = await Promise.all([api.listKradleAgents(), fetchOpenRouterPricing()]);
         agents.sort((a, b) => a.username?.localeCompare(b.username || "") || 0);
+        // Calculate column widths
+        const rows = agents.map((agent) => {
+            const username = agent.username || "";
+            const model = agent.agentConfig && "model" in agent.agentConfig ? agent.agentConfig.model : "";
+            const costs = model ? pricing.get(model) : undefined;
+            const inputRaw = costs ? formatCost(costs.input) : "-";
+            const outputRaw = costs ? formatCost(costs.output) : "-";
+            const inputColored = colorizeCost(inputRaw, costs?.input);
+            const outputColored = colorizeCost(outputRaw, costs?.output);
+            return { username, model, inputRaw, outputRaw, inputColored, outputColored };
+        });
+        const nameWidth = Math.max("Agent".length, ...rows.map((r) => r.username.length));
+        const modelWidth = Math.max("Model".length, ...rows.map((r) => r.model.length));
+        const inputWidth = Math.max("Input/MTok".length, ...rows.map((r) => r.inputRaw.length));
+        const outputWidth = Math.max("Output/MTok".length, ...rows.map((r) => r.outputRaw.length));
         this.log(pc.bold(`\nFound ${agents.length} agents:\n`));
-        for (const agent of agents) {
-            this.log(pc.bold(`- ${agent.username}`));
+        // Header
+        const header = `  ${pc.bold("Agent".padEnd(nameWidth))}  ${pc.bold("Model".padEnd(modelWidth))}  ${pc.bold("Input/MTok".padEnd(inputWidth))}  ${pc.bold("Output/MTok".padEnd(outputWidth))}`;
+        this.log(header);
+        this.log(`  ${"─".repeat(nameWidth)}  ${"─".repeat(modelWidth)}  ${"─".repeat(inputWidth)}  ${"─".repeat(outputWidth)}`);
+        for (const row of rows) {
+            // Pad using raw (uncolored) width, then replace with colored version
+            const inputPad = " ".repeat(Math.max(0, inputWidth - row.inputRaw.length));
+            const outputPad = " ".repeat(Math.max(0, outputWidth - row.outputRaw.length));
+            this.log(`  ${pc.bold(row.username.padEnd(nameWidth))}  ${row.model.padEnd(modelWidth)}  ${row.inputColored}${inputPad}  ${row.outputColored}${outputPad}`);
         }
     }
 }

package/dist/commands/{update.d.ts → ai-docs/sync.d.ts}

@@ -1,5 +1,5 @@
 import { Command } from "@oclif/core";
-export default class Update extends Command {
+export default class Sync extends Command {
     static description: string;
     static examples: string[];
     static flags: {

package/dist/commands/{update.js → ai-docs/sync.js}

@@ -3,11 +3,11 @@ import path from "node:path";
 import { Command, Flags } from "@oclif/core";
 import enquirer from "enquirer";
 import pc from "picocolors";
-import { getStaticResourcePath } from "../lib/utils.js";
+import { getStaticResourcePath } from "../../lib/utils.js";
 // Files that should be synced on update (documentation files only)
 const SYNC_FILES = ["AGENTS.md", "CLAUDE.md"];
-export default class Update extends Command {
-    static description = "Update project template files (AGENTS.md, CLAUDE.md) to the latest version from the CLI";
+export default class Sync extends Command {
+    static description = "Sync project AI docs (AGENTS.md, CLAUDE.md) to the latest version from the CLI";
     static examples = [
         "<%= config.bin %> <%= command.id %>",
         "<%= config.bin %> <%= command.id %> --dry-run",
@@ -96,7 +96,7 @@ export default class Update extends Command {
         this.log(pc.dim("  (file contents differ - will be replaced with template version)"));
     }
     async run() {
-        const { flags } = await this.parse(Update);
+        const { flags } = await this.parse(Sync);
         const isDryRun = flags["dry-run"];
         const skipPrompts = flags.yes;
         const addMissing = flags["add-missing"];

package/dist/commands/challenge/run.d.ts

@@ -19,7 +19,6 @@ export default class Run extends Command {
         "arena-image": import("@oclif/core/interfaces").OptionFlag<string | undefined, import("@oclif/core/interfaces").CustomOptions>;
         "no-open": import("@oclif/core/interfaces").BooleanFlag<boolean>;
         "no-wait": import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        "no-summary": import("@oclif/core/interfaces").BooleanFlag<boolean>;
         screenshots: import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     private pollForCompletion;

package/dist/commands/challenge/run.js

@@ -51,20 +51,14 @@ export default class Run extends Command {
             description: "Don't wait for the run to complete (fire and forget)",
             default: false,
         }),
-        "no-summary": Flags.boolean({
-            description: "Don't wait for the AI-generated summary",
-            default: false,
-        }),
         screenshots: Flags.boolean({
             description: "Open the run URL with screenshots mode enabled",
             default: false,
         }),
         ...getConfigFlags("api-key", "api-url", "web-url", "studio-url", "studio-api-url", "challenges-path"),
     };
-    async pollForCompletion(api, runId, waitForSummary) {
+    async pollForCompletion(api, runId) {
         let lastStatus = "";
-        let reachedTerminal = false;
-        let waitingForSummary = false;
         const startTime = Date.now();
         while (true) {
             // Check for timeout
@@ -83,18 +77,6 @@ export default class Run extends Command {
             }
             // Check for terminal state
             if (TERMINAL_STATUSES.includes(currentStatus)) {
-                if (!reachedTerminal) {
-                    reachedTerminal = true;
-                }
-                // If we need to wait for summary and it's not available yet, keep polling
-                if (waitForSummary && !result.summary) {
-                    if (!waitingForSummary) {
-                        waitingForSummary = true;
-                        this.log(pc.dim(`Waiting for summary...`));
-                    }
-                    await new Promise((resolve) => setTimeout(resolve, POLL_INTERVAL_MS));
-                    continue;
-                }
                 this.log("");
                 this.displayRunResult(result);
                 return;
@@ -119,10 +101,6 @@ export default class Run extends Command {
                 this.log(`  ${winnerIcon} ${participantId}: ${pr.agent}${score}`);
             }
         }
-        if (result.summary) {
-            this.log(pc.bold("\n=== Summary ===\n"));
-            this.log(result.summary);
-        }
     }
     /**
      * Parse inline agent arguments into participants.
@@ -409,7 +387,7 @@ export default class Run extends Command {
                 }
                 if (!flags["no-wait"]) {
                     this.log(pc.blue("\n>> Waiting for run to complete...\n"));
-                    await this.pollForCompletion(api, runId, !flags["no-summary"]);
+                    await this.pollForCompletion(api, runId);
                 }
             }
             else {

package/dist/commands/challenge/runs/get.d.ts

@@ -9,7 +9,6 @@ export default class GetRun extends Command {
         "api-key": import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         "api-url": import("@oclif/core/interfaces").OptionFlag<string, import("@oclif/core/interfaces").CustomOptions>;
         "no-logs": import("@oclif/core/interfaces").BooleanFlag<boolean>;
-        "no-summary": import("@oclif/core/interfaces").BooleanFlag<boolean>;
     };
     run(): Promise<void>;
 }

package/dist/commands/challenge/runs/get.js

@@ -35,7 +35,6 @@ export default class GetRun extends Command {
     static examples = [
         "<%= config.bin %> <%= command.id %> abc123",
         "<%= config.bin %> <%= command.id %> abc123 --no-logs",
-        "<%= config.bin %> <%= command.id %> abc123 --no-summary",
     ];
     static args = {
         runId: Args.string({
@@ -48,17 +47,12 @@ export default class GetRun extends Command {
             description: "Skip fetching and displaying logs",
             default: false,
         }),
-        "no-summary": Flags.boolean({
-            description: "Skip displaying the AI-generated summary",
-            default: false,
-        }),
         ...getConfigFlags("api-key", "api-url"),
     };
     async run() {
         const { args, flags } = await this.parse(GetRun);
         const api = new ApiClient(flags["api-url"], flags["api-key"]);
         const showLogs = !flags["no-logs"];
-        const showSummary = !flags["no-summary"];
         this.log(pc.blue(`>> Loading run ${args.runId}...`));
         try {
             const [runResult, logs] = await Promise.all([
@@ -100,11 +94,6 @@ export default class GetRun extends Command {
                     this.log(`${participantId.padEnd(widths[0])} ${agentPadded} ${winner} ${score.padEnd(widths[3])} ${timeToSuccess}`);
                 }
             }
-            // AI Summary
-            if (showSummary && runResult.summary) {
-                this.log(pc.bold("\n=== Summary ===\n"));
-                this.log(runResult.summary);
-            }
             // Logs
             if (showLogs) {
                 // Filter out logs with 'prompt' key (verbose LLM prompts)

package/dist/config/releases/arena-minecraft.d.ts

@@ -1 +1 @@
-export declare const MINECRAFT_ARENA_MANAGER_TAG = "8534933";
+export declare const MINECRAFT_ARENA_MANAGER_TAG = "14f7331";

package/dist/config/releases/arena-minecraft.js

@@ -1,2 +1,2 @@
 // Managed by https://github.com/Kradle-ai/arena-minecraft/actions/workflows/release.yaml
-export const MINECRAFT_ARENA_MANAGER_TAG = "8534933";
+export const MINECRAFT_ARENA_MANAGER_TAG = "14f7331";

package/dist/lib/challenge.js

@@ -169,17 +169,16 @@ export class Challenge {
      */
     async buildLocal(options = { validate: true }) {
         const { validate = true } = options;
+        // Ensure challenge exists locally
+        if (!this.exists()) {
+            throw new Error(`Challenge "${this.shortSlug}" does not exist locally. Make sure both the challenge.ts file and the config.ts file exist.`);
+        }
         // Start validation service initialization in parallel with build (if validation enabled)
         // This overlaps the init time with the build process.
         let validationService = null;
         if (validate) {
             validationService = ValidationService.create(this.builtDatapackPath);
         }
-        // Ensure challenge exists locally
-        if (!this.exists()) {
-            await validationService?.close();
-            throw new Error(`Challenge "${this.shortSlug}" does not exist locally. Make sure both the challenge.ts file and the config.ts file exist.`);
-        }
         const config = await this.loadConfig();
         // Build datapack (validation service initializes in parallel)
         console.log(pc.blue(`>> Building datapack: ${this.shortSlug}`));
@@ -390,6 +389,7 @@ export class Challenge {
             challengeConfig: challengeData.challengeConfig,
             description: challengeData.description,
             task: challengeData.task,
+            scoreLabel: challengeData.scoreLabel,
             roles: challengeData.roles,
             objective: challengeData.objective,
             endStates: sortedEndStates,

package/dist/lib/experiment/experimenter.js

@@ -257,9 +257,12 @@ export class Experimenter {
         this.currentVersion = version;
         // Load manifest
         const manifest = await this.loadManifest(version);
-        // We have 2 mandatory tags: "exp-<experiment-name>" and "exp-<experiment-name>-v<version>"
-        const experimentTag = `exp-${this.name}`;
-        const versionTag = `${experimentTag}-v${version}`;
+        // Fetch the user's slug to prefix tags for uniqueness
+        const human = await this.api.getHuman();
+        const prefix = human.username;
+        // We have 2 mandatory tags: "<user>(<exp-name>)" and "<user>(<exp-name>-v<version>)"
+        const experimentTag = `${prefix}(exp-${this.name})`;
+        const versionTag = `${prefix}(exp-${this.name}-v${version})`;
         const tags = [experimentTag, versionTag, ...(manifest.tags ?? [])];
         // Create runner
         this.runner = new Runner(manifest.runs, this.api, this.webUrl, {

package/dist/lib/local-runner.js

@@ -14,6 +14,23 @@ const SERVER_READY_TIMEOUT_MS = 120_000;
 const SERVER_READY_POLL_MS = 3_000;
 const CONTAINER_NAME_PREFIX_MC = "kradle-mc-server";
 const CONTAINER_NAME_PREFIX_ARENA = "kradle-arena";
+// Debug environment variables — mirrors the flags in Studio's MinecraftDomainAdapter.
+//
+// DEBUG_LOCAL_ARENA_MINECRAFT=true
+//   Uses a local dev image ("local-arena-minecraft-dev") and volume-mounts
+//   the arena-minecraft source tree so changes are picked up without rebuilding.
+//   Build the image with "docker compose build" inside the arena-minecraft repo.
+//
+// DEBUG_LOCAL_ARENA_MINECRAFT_WAIT=true
+//   Additionally starts Node with --inspect-wait so it pauses until a debugger
+//   attaches (requires Node 22+). Without this flag, --inspect is used instead.
+//
+// ARENA_MINECRAFT_SOURCE_PATH
+//   Path to the arena-minecraft source tree. Defaults to "../arena-minecraft"
+//   relative to cwd.
+const DEBUG_LOCAL_ARENA = process.env.DEBUG_LOCAL_ARENA_MINECRAFT === "true";
+const DEBUG_LOCAL_ARENA_WAIT = process.env.DEBUG_LOCAL_ARENA_MINECRAFT_WAIT === "true";
+const ARENA_DEBUG_PORT = 9229;
 export class LocalRunner {
     config;
     mcContainerId = null;
@@ -232,6 +249,9 @@ export class LocalRunner {
             containerName,
             "-p",
             `${MC_PORT}:${MC_PORT}`,
+            // The arena container shares this container's network, so we must
+            // publish the debug port here.
+            ...(DEBUG_LOCAL_ARENA ? ["-p", `${ARENA_DEBUG_PORT}:${ARENA_DEBUG_PORT}`] : []),
             "-v",
             `${serverDir}:/data`,
             "-e",
@@ -280,9 +300,38 @@ export class LocalRunner {
             `PROMPT_AGENT_BASE_URL=${agentBaseUrl}`,
             "-e",
             "MAX_IDLE_TIME=-1",
-            arenaImage,
-            `--job=${jobPayload}`,
         ];
+        if (DEBUG_LOCAL_ARENA) {
+            // Volume-mount the local source tree so edits are reflected without
+            // rebuilding the image.
+            const sourcePath = process.env.ARENA_MINECRAFT_SOURCE_PATH
+                ? path.resolve(process.env.ARENA_MINECRAFT_SOURCE_PATH)
+                : path.resolve("../arena-minecraft/src");
+            args.push("-v", `${sourcePath}:/usr/src/app/src`);
+            // Override the entrypoint to run via ts-node so we execute from source.
+            args.push("--entrypoint", "node");
+            // Extra logging in debug mode.
+            args.push("-e", "LOGGING=true");
+            // Use the local dev image (built via "docker compose build" in arena-minecraft).
+            args.push("local-arena-minecraft-dev:latest");
+            // Node inspector flags — must come after the image name (they are the
+            // container CMD, not docker args).
+            if (DEBUG_LOCAL_ARENA_WAIT) {
+                args.push(`--inspect-wait=0.0.0.0:${ARENA_DEBUG_PORT}`);
+            }
+            else {
+                args.push(`--inspect=0.0.0.0:${ARENA_DEBUG_PORT}`);
+            }
+            // Run from TypeScript source via ts-node.
+            args.push("--loader", "ts-node/esm", "--no-warnings", "/usr/src/app/src/index.ts");
+            // Job payload comes last.
+            args.push(`--job=${jobPayload}`);
+        }
+        else {
+            // Production path: use the pre-built image.
+            args.push(arenaImage);
+            args.push(`--job=${jobPayload}`);
+        }
         // Use execFileSync to bypass shell — the JSON payload contains quotes,
         // parentheses, and other characters that break shell parsing.
         const result = execFileSync("docker", args, {

package/dist/lib/schemas.d.ts

@@ -64,9 +64,13 @@ export declare const ChallengeSchema: z.ZodObject<{
                 z: z.ZodNumber;
             }, z.core.$strip>>;
         }, z.core.$strip>>>;
+        tickRate: z.ZodOptional<z.ZodNumber>;
+        startLives: z.ZodOptional<z.ZodNumber>;
+        watcherCommands: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
     description: z.ZodOptional<z.ZodString>;
     task: z.ZodOptional<z.ZodString>;
+    scoreLabel: z.ZodOptional<z.ZodString>;
     roles: z.ZodRecord<z.ZodString, z.ZodObject<{
         description: z.ZodOptional<z.ZodString>;
         specificTask: z.ZodOptional<z.ZodString>;
@@ -107,8 +111,12 @@ export declare const ChallengeConfigSchema: z.ZodObject<{
                 z: z.ZodNumber;
             }, z.core.$strip>>;
         }, z.core.$strip>>>;
+        tickRate: z.ZodOptional<z.ZodNumber>;
+        startLives: z.ZodOptional<z.ZodNumber>;
+        watcherCommands: z.ZodOptional<z.ZodString>;
     }, z.core.$strip>;
     task: z.ZodOptional<z.ZodString>;
+    scoreLabel: z.ZodOptional<z.ZodString>;
     roles: z.ZodRecord<z.ZodString, z.ZodObject<{
         description: z.ZodOptional<z.ZodString>;
         specificTask: z.ZodOptional<z.ZodString>;
@@ -153,9 +161,13 @@ export declare const ChallengesResponseSchema: z.ZodObject<{
                     z: z.ZodNumber;
                 }, z.core.$strip>>;
             }, z.core.$strip>>>;
+            tickRate: z.ZodOptional<z.ZodNumber>;
+            startLives: z.ZodOptional<z.ZodNumber>;
+            watcherCommands: z.ZodOptional<z.ZodString>;
         }, z.core.$strip>;
         description: z.ZodOptional<z.ZodString>;
         task: z.ZodOptional<z.ZodString>;
+        scoreLabel: z.ZodOptional<z.ZodString>;
         roles: z.ZodRecord<z.ZodString, z.ZodObject<{
             description: z.ZodOptional<z.ZodString>;
             specificTask: z.ZodOptional<z.ZodString>;
@@ -209,6 +221,25 @@ export declare const DownloadUrlResponseSchema: z.ZodObject<{
     downloadUrl: z.ZodString;
     expiresAt: z.ZodString;
 }, z.core.$strip>;
+export declare const PromptConfigSchema: z.ZodObject<{
+    model: z.ZodString;
+    persona: z.ZodOptional<z.ZodString>;
+    respondWithCode: z.ZodOptional<z.ZodBoolean>;
+    skinUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const SdkV0ConfigSchema: z.ZodObject<{
+    url: z.ZodString;
+    skinUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export declare const AgentConfigSchema: z.ZodUnion<readonly [z.ZodObject<{
+    model: z.ZodString;
+    persona: z.ZodOptional<z.ZodString>;
+    respondWithCode: z.ZodOptional<z.ZodBoolean>;
+    skinUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{
+    url: z.ZodString;
+    skinUrl: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>, z.ZodObject<{}, z.core.$strip>]>;
 export declare const AgentSchema: z.ZodObject<{
     username: z.ZodOptional<z.ZodString>;
     name: z.ZodOptional<z.ZodString>;
@@ -223,6 +254,21 @@ export declare const AgentSchema: z.ZodObject<{
     deletionTime: z.ZodOptional<z.ZodString>;
     creatorId: z.ZodOptional<z.ZodString>;
     originalCreatorId: z.ZodOptional<z.ZodString>;
+    agentType: z.ZodOptional<z.ZodEnum<{
+        prompt: "prompt";
+        experimental: "experimental";
+        sdk_v0: "sdk_v0";
+        kradleverse_human: "kradleverse_human";
+    }>>;
+    agentConfig: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+        model: z.ZodString;
+        persona: z.ZodOptional<z.ZodString>;
+        respondWithCode: z.ZodOptional<z.ZodBoolean>;
+        skinUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{
+        url: z.ZodString;
+        skinUrl: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>, z.ZodObject<{}, z.core.$strip>]>>;
 }, z.core.$strip>;
 export declare const AgentsResponseSchema: z.ZodObject<{
     agents: z.ZodArray<z.ZodObject<{
@@ -239,6 +285,21 @@ export declare const AgentsResponseSchema: z.ZodObject<{
         deletionTime: z.ZodOptional<z.ZodString>;
         creatorId: z.ZodOptional<z.ZodString>;
         originalCreatorId: z.ZodOptional<z.ZodString>;
+        agentType: z.ZodOptional<z.ZodEnum<{
+            prompt: "prompt";
+            experimental: "experimental";
+            sdk_v0: "sdk_v0";
+            kradleverse_human: "kradleverse_human";
+        }>>;
+        agentConfig: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+            model: z.ZodString;
+            persona: z.ZodOptional<z.ZodString>;
+            respondWithCode: z.ZodOptional<z.ZodBoolean>;
+            skinUrl: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{
+            url: z.ZodString;
+            skinUrl: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>, z.ZodObject<{}, z.core.$strip>]>>;
     }, z.core.$strip>>;
     nextPageToken: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
@@ -303,7 +364,6 @@ export declare const RunResultResponseSchema: z.ZodObject<{
         score: z.ZodOptional<z.ZodNumber>;
         timeToSuccess: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>>>;
-    summary: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 export declare const WorldSchema: z.ZodObject<{
     id: z.ZodString;

package/dist/lib/schemas.js

@@ -31,9 +31,13 @@ export const ChallengeSchema = z.object({
         datapack: z.boolean(),
         gameMode: z.enum(["survival", "creative", "adventure", "spectator"]),
         locations: ChallengeLocationsSchema.optional(),
+        tickRate: z.number().min(5).max(25).optional(),
+        startLives: z.number().optional(),
+        watcherCommands: z.string().optional(),
     }),
     description: z.string().optional(),
     task: z.string().optional(),
+    scoreLabel: z.string().optional(),
     roles: z.record(z.string(), z.object({
         description: z.string().optional(),
         specificTask: z.string().optional(),
@@ -90,6 +94,17 @@ export const DownloadUrlResponseSchema = z.object({
     downloadUrl: z.string(),
     expiresAt: z.string(),
 });
+export const PromptConfigSchema = z.object({
+    model: z.string(),
+    persona: z.string().optional(),
+    respondWithCode: z.boolean().optional(),
+    skinUrl: z.string().optional(),
+});
+export const SdkV0ConfigSchema = z.object({
+    url: z.string(),
+    skinUrl: z.string().optional(),
+});
+export const AgentConfigSchema = z.union([PromptConfigSchema, SdkV0ConfigSchema, z.object({})]);
 export const AgentSchema = z.object({
     username: z.string().optional(),
     name: z.string().optional(),
@@ -100,6 +115,8 @@ export const AgentSchema = z.object({
     deletionTime: z.string().optional(),
     creatorId: z.string().optional(),
     originalCreatorId: z.string().optional(),
+    agentType: z.enum(["prompt", "experimental", "sdk_v0", "kradleverse_human"]).optional(),
+    agentConfig: AgentConfigSchema.optional(),
 });
 export const AgentsResponseSchema = z.object({
     agents: z.array(AgentSchema),
@@ -146,7 +163,6 @@ export const RunResultResponseSchema = z.object({
     endTime: z.string().optional(),
     aggregatedResults: RunAggregatedResultsSchema.optional(),
     participantResults: z.record(z.string(), RunParticipantResultSchema).optional(),
-    summary: z.string().optional(),
 });
 export const WorldSchema = z.object({
     id: z.string(),

package/oclif.manifest.json

@@ -42,39 +42,37 @@
         "init.js"
       ]
     },
-    "update": {
+    "agent:list": {
       "aliases": [],
       "args": {},
-      "description": "Update project template files (AGENTS.md, CLAUDE.md) to the latest version from the CLI",
+      "description": "List all agents",
       "examples": [
-        "<%= config.bin %> <%= command.id %>",
-        "<%= config.bin %> <%= command.id %> --dry-run",
-        "<%= config.bin %> <%= command.id %> --yes"
+        "<%= config.bin %> <%= command.id %>"
       ],
       "flags": {
-        "dry-run": {
-          "description": "Preview changes without applying them",
-          "name": "dry-run",
-          "allowNo": false,
-          "type": "boolean"
-        },
-        "yes": {
-          "char": "y",
-          "description": "Skip confirmation prompts",
-          "name": "yes",
-          "allowNo": false,
-          "type": "boolean"
+        "api-key": {
+          "description": "Kradle API key",
+          "env": "KRADLE_API_KEY",
+          "name": "api-key",
+          "required": true,
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         },
-        "add-missing": {
-          "description": "Add files that exist in template but not locally",
-          "name": "add-missing",
-          "allowNo": false,
-          "type": "boolean"
+        "api-url": {
+          "description": "Kradle Web API URL",
+          "env": "KRADLE_API_URL",
+          "name": "api-url",
+          "required": true,
+          "default": "https://api.kradle.ai/v0",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "type": "option"
         }
       },
       "hasDynamicHelp": false,
       "hiddenAliases": [],
-      "id": "update",
+      "id": "agent:list",
       "pluginAlias": "kradle",
       "pluginName": "kradle",
       "pluginType": "core",
@@ -84,7 +82,8 @@
       "relativePath": [
         "dist",
         "commands",
-        "update.js"
+        "agent",
+        "list.js"
       ]
     },
     "ai-docs:challenges-sdk": {
@@ -143,6 +142,52 @@
         "cli.js"
       ]
     },
+    "ai-docs:sync": {
+      "aliases": [],
+      "args": {},
+      "description": "Sync project AI docs (AGENTS.md, CLAUDE.md) to the latest version from the CLI",
+      "examples": [
+        "<%= config.bin %> <%= command.id %>",
+        "<%= config.bin %> <%= command.id %> --dry-run",
+        "<%= config.bin %> <%= command.id %> --yes"
+      ],
+      "flags": {
+        "dry-run": {
+          "description": "Preview changes without applying them",
+          "name": "dry-run",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "yes": {
+          "char": "y",
+          "description": "Skip confirmation prompts",
+          "name": "yes",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "add-missing": {
+          "description": "Add files that exist in template but not locally",
+          "name": "add-missing",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "ai-docs:sync",
+      "pluginAlias": "kradle",
+      "pluginName": "kradle",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "ai-docs",
+        "sync.js"
+      ]
+    },
     "ai-docs:workflow": {
       "aliases": [],
       "args": {},
@@ -582,12 +627,6 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "no-summary": {
-          "description": "Don't wait for the AI-generated summary",
-          "name": "no-summary",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "screenshots": {
           "description": "Open the run URL with screenshots mode enabled",
           "name": "screenshots",
@@ -1390,50 +1429,6 @@
         "push.js"
       ]
     },
-    "agent:list": {
-      "aliases": [],
-      "args": {},
-      "description": "List all agents",
-      "examples": [
-        "<%= config.bin %> <%= command.id %>"
-      ],
-      "flags": {
-        "api-key": {
-          "description": "Kradle API key",
-          "env": "KRADLE_API_KEY",
-          "name": "api-key",
-          "required": true,
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        },
-        "api-url": {
-          "description": "Kradle Web API URL",
-          "env": "KRADLE_API_URL",
-          "name": "api-url",
-          "required": true,
-          "default": "https://api.kradle.ai/v0",
-          "hasDynamicHelp": false,
-          "multiple": false,
-          "type": "option"
-        }
-      },
-      "hasDynamicHelp": false,
-      "hiddenAliases": [],
-      "id": "agent:list",
-      "pluginAlias": "kradle",
-      "pluginName": "kradle",
-      "pluginType": "core",
-      "strict": true,
-      "enableJsonFlag": false,
-      "isESM": true,
-      "relativePath": [
-        "dist",
-        "commands",
-        "agent",
-        "list.js"
-      ]
-    },
     "challenge:runs:get": {
       "aliases": [],
       "args": {
@@ -1446,8 +1441,7 @@
       "description": "Get details and logs for a specific run",
       "examples": [
         "<%= config.bin %> <%= command.id %> abc123",
-        "<%= config.bin %> <%= command.id %> abc123 --no-logs",
-        "<%= config.bin %> <%= command.id %> abc123 --no-summary"
+        "<%= config.bin %> <%= command.id %> abc123 --no-logs"
       ],
       "flags": {
         "no-logs": {
@@ -1456,12 +1450,6 @@
           "allowNo": false,
           "type": "boolean"
         },
-        "no-summary": {
-          "description": "Skip displaying the AI-generated summary",
-          "name": "no-summary",
-          "allowNo": false,
-          "type": "boolean"
-        },
         "api-key": {
           "description": "Kradle API key",
           "env": "KRADLE_API_KEY",
@@ -1555,5 +1543,5 @@
       ]
     }
   },
-  "version": "0.6.8"
+  "version": "0.6.10"
 }

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "kradle",
-	"version": "0.6.8",
+	"version": "0.6.10",
 	"description": "Kradle's CLI. Manage challenges, experiments, agents and more!",
 	"keywords": [
 		"cli"

package/static/ai_docs/LLM_CLI_REFERENCE.md

@@ -421,7 +421,6 @@ When no agents are specified, the command enters interactive mode:
 | `--arena-image` | | Override arena-minecraft Docker image URL (env: `KRADLE_ARENA_IMAGE`) |
 | `--no-open` | | Don't open the run URL in the browser |
 | `--no-wait` | | Don't wait for completion (fire and forget) |
-| `--no-summary` | | Don't wait for the AI-generated summary |
 
 **Behavior (remote, default):**
 1. Parses inline agents or enters interactive mode for agent selection
@@ -545,7 +544,6 @@ Gets details and optionally logs for a specific run.
 ```bash
 kradle challenge runs get <run-id>
 kradle challenge runs get <run-id> --no-logs
-kradle challenge runs get <run-id> --no-summary
 ```
 
 **Arguments:**
@@ -557,7 +555,6 @@ kradle challenge runs get <run-id> --no-summary
 | Flag | Description | Default |
 |------|-------------|---------|
 | `--no-logs` | Skip fetching and displaying logs | false |
-| `--no-summary` | Skip displaying the AI-generated summary | false |
 
 **Output sections:**
 
@@ -570,9 +567,7 @@ kradle challenge runs get <run-id> --no-summary
 3. **Participant Results** - Per-participant breakdown (table format):
    - Participant ID, Agent name, Winner status, Score, Time to Success
 
-4. **Summary** - AI-generated summary of the run (unless `--no-summary` is used)
-
-5. **Logs** - Log entries from the run (unless `--no-logs` is used):
+4. **Logs** - Log entries from the run (unless `--no-logs` is used):
    - Timestamp, Level (colored), Participant ID, Message
    - JSON messages are automatically parsed and formatted
 
@@ -590,9 +585,6 @@ kradle challenge runs get abc123def456
 # Get details without logs (faster)
 kradle challenge runs get abc123def456 --no-logs
 
-# Get details without AI summary
-kradle challenge runs get abc123def456 --no-summary
-
 # Get details for a run (full ID)
 kradle challenge runs get 12345678-1234-1234-1234-123456789012
 ```
@@ -1145,7 +1137,9 @@ export const config = {
 
 ### `kradle agent list`
 
-Lists all agents registered in the Kradle system.
+Lists all agents registered in the Kradle system with their model and pricing information.
+
+Pricing (input/output cost per million tokens) is fetched from the OpenRouter API. Models without pricing data show `-`.
 
 **Usage:**
 ```bash
@@ -1154,10 +1148,13 @@ kradle agent list
 
 **Output format:**
 ```
-Agents:
-  - team-kradle:baseline-agent
-  - team-kradle:advanced-agent
-  - my-username:custom-agent
+Found 451 agents:
+
+  Agent                          Model                        Input/MTok  Output/MTok
+  ─────────────────────────────  ───────────────────────────  ──────────  ───────────
+  team-kradle:claude-sonnet-4-6  anthropic/claude-sonnet-4.6  $3.00       $15.00
+  team-kradle:gemini-2-5-flash   google/gemini-2.5-flash      $0.30       $2.50
+  team-kradle:gpt-4o             openai/gpt-4o                $2.50       $10.00
 ```
 
 **Example:**
@@ -1234,6 +1231,46 @@ kradle ai-docs challenges-sdk > api-reference.md
 
 ---
 
+### `kradle ai-docs sync`
+
+Syncs project AI docs (`AGENTS.md`, `CLAUDE.md`) to the latest version bundled with the CLI.
+
+**Usage:**
+```bash
+kradle ai-docs sync
+kradle ai-docs sync --dry-run
+kradle ai-docs sync --yes
+kradle ai-docs sync --add-missing
+```
+
+**Flags:**
+| Flag | Description | Default |
+|------|-------------|---------|
+| `--dry-run` | Preview changes without applying them | `false` |
+| `--yes` / `-y` | Skip confirmation prompts | `false` |
+| `--add-missing` | Add files that exist in template but not locally | `false` |
+
+**Behavior:**
+- Compares local `AGENTS.md` and `CLAUDE.md` against the templates in the CLI's `static/project_template/` directory
+- Shows status for each file: identical, different, or missing locally
+- Displays line count diff for changed files
+- Prompts for confirmation before overwriting (unless `--yes`)
+- Missing files are only created when `--add-missing` is specified
+
+**Examples:**
+```bash
+# Check what would change
+kradle ai-docs sync --dry-run
+
+# Update all changed files without prompting
+kradle ai-docs sync --yes
+
+# Update changed files and create any missing ones
+kradle ai-docs sync --yes --add-missing
+```
+
+---
+
 ## Common Workflows
 
 ### Creating and Testing a New Challenge
@@ -1336,6 +1373,7 @@ kradle challenge build --all --public
 | `kradle world pull [slug]` | Pull world from cloud |
 | `kradle world list` | List all worlds |
 | `kradle world delete <slug>` | Delete world |
-| `kradle agent list` | List available agents |
+| `kradle agent list` | List agents with model pricing |
 | `kradle ai-docs cli` | Output CLI reference for LLMs |
 | `kradle ai-docs challenges-sdk [version]` | Output SDK reference for LLMs |
+| `kradle ai-docs sync` | Sync project AI docs to latest CLI version |