kradle 0.6.12 → 0.6.14

package/README.md

@@ -411,6 +411,8 @@ List all agents registered in the system with their model and pricing informatio
 kradle agent list
 ```
 
+Agents whose model is no longer listed on OpenRouter are considered unavailable and hidden from the table.
+
 ## AI Docs Commands
 
 Output LLM-focused documentation to stdout, or sync local AI docs with the latest version from the CLI.

package/dist/commands/agent/list.js

@@ -57,8 +57,16 @@ export default class List extends Command {
         this.log(pc.blue(">> Loading agents..."));
         const [agents, pricing] = await Promise.all([api.listKradleAgents(), fetchOpenRouterPricing()]);
         agents.sort((a, b) => a.username?.localeCompare(b.username || "") || 0);
+        // Drop agents whose model is no longer listed on OpenRouter. Skip filtering if the
+        // pricing fetch failed (empty map) so a transient outage doesn't hide everything.
+        const visibleAgents = pricing.size === 0
+            ? agents
+            : agents.filter((agent) => {
+                const model = agent.agentConfig && "model" in agent.agentConfig ? agent.agentConfig.model : "";
+                return !model || pricing.has(model);
+            });
         // Calculate column widths
-        const rows = agents.map((agent) => {
+        const rows = visibleAgents.map((agent) => {
             const username = agent.username || "";
             const model = agent.agentConfig && "model" in agent.agentConfig ? agent.agentConfig.model : "";
             const costs = model ? pricing.get(model) : undefined;
@@ -72,7 +80,7 @@ export default class List extends Command {
         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`));
+        this.log(pc.bold(`\nFound ${visibleAgents.length} agents:\n`));
         // 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);

package/oclif.manifest.json

@@ -1543,5 +1543,5 @@
       ]
     }
   },
-  "version": "0.6.12"
+  "version": "0.6.14"
 }

package/package.json

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

package/static/ai_docs/LLM_CLI_REFERENCE.md

@@ -1137,10 +1137,12 @@ export const config = {
 
 ### `kradle agent list`
 
-Lists all agents registered in the Kradle system with their model and pricing information.
+Lists 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 `-`.
 
+Agents whose model is no longer listed on OpenRouter (deprecated/unavailable) are hidden from the table. If the OpenRouter pricing fetch fails entirely, this filtering is skipped so the command still shows the full list during transient outages.
+
 **Usage:**
 ```bash
 kradle agent list
@@ -1148,7 +1150,7 @@ kradle agent list
 
 **Output format:**
 ```
-Found 451 agents:
+Found 430 agents:
 
   Agent                          Model                        Input/MTok  Output/MTok
   ─────────────────────────────  ───────────────────────────  ──────────  ───────────

package/static/ai_docs/WORKFLOW.md

@@ -45,6 +45,18 @@ Gather requirements by asking these questions. Save answers in a markdown summar
 
 **Important**: roles should just be alphanumeric, no hypen no underscore
 
+**Targeting a role in Actions:** Roles are implemented as player **tags**, not Minecraft scoreboard teams. To target all players of a role, pass the role name as a string to any Action's `target`:
+
+```typescript
+// Teleport all "red" role players to (15, 0, -60)
+Actions.teleport({ target: "red", x: 15, y: 0, z: -60, absolute: true });
+
+// Give items to "blue" role players
+Actions.give({ target: "blue", item: "minecraft:iron_sword", count: 1 });
+```
+
+Under the hood this resolves to `@a[tag=<role>]`. If you need a raw selector, use `Selector("@a", { tag: "red" })` — **not** `{ team: "red" }` (no scoreboard team of that name exists).
+
 ### Things to consider when building a challenge:
 
 - Agents don't "see" the world with images, they get JSON observations about the world, so if you want them to take a specific path, you need to put a marker and tell the agent to follow that marker. The agent will use A* algorithm to go to the marker.