@myvillage/cli 2.9.0 → 2.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myvillage/cli",
-  "version": "2.9.0",
+  "version": "2.10.0",
   "description": "MyVillageOS CLI for community developers",
   "type": "module",
   "bin": {

package/src/agent-runtime/builtin-tools-registry.js

@@ -59,3 +59,25 @@ export const BUILTIN_TOOL_DEFS = [
     builtin: true,
   },
 ];
+
+/** One line telling an agent what a local model is for and what it takes. */
+export function describeLocalModel(m) {
+  const f = m.featurization ?? {};
+  const modality = f.modality ?? m.modality;
+  let takes;
+  if (modality === 'image') takes = 'a local image file path (.jpg/.png)';
+  else if (modality === 'audio') takes = 'a local .wav file path';
+  else if (modality === 'text') takes = 'some writing';
+  else if (Array.isArray(f.columns)) {
+    takes = 'a table row with ' + f.columns.map((c) => `${JSON.stringify(c.name)} (${c.type})`).join(', ');
+  } else if (Array.isArray(m.featureNames) && m.featureNames.length) {
+    takes = 'a table row of numbers: ' + m.featureNames.map((n) => JSON.stringify(n)).join(', ');
+  } else {
+    takes = `a list of ${m.inputDim ?? 'some'} numbers`;
+  }
+  const gives =
+    m.taskType === 'classification' && Array.isArray(m.labels) && m.labels.length
+      ? `sorts it into: ${m.labels.join(', ')}`
+      : 'gives back a number';
+  return `- "${m.slug}" (${m.name}): takes ${takes}; ${gives}.`;
+}

package/src/agent-runtime/context.js

@@ -13,6 +13,7 @@
 
 import { listDatasets } from '../utils/dataset-workspace.js';
 import { listModels } from '../utils/model-workspace.js';
+import { describeLocalModel } from './builtin-tools-registry.js';
 
 export async function gatherContext(agentConfig, lastCheckIn, recentActions = []) {
   const parts = [];
@@ -52,11 +53,8 @@ export async function gatherContext(agentConfig, lastCheckIn, recentActions = []
   try {
     const models = listModels();
     if (models.length > 0) {
-      parts.push('\nLocal models you can run with model_predict (use the slug as modelId):');
-      for (const m of models.slice(0, 25)) {
-        const labels = m.labels?.length ? ` → ${m.labels.join('/')}` : '';
-        parts.push(`- ${m.slug} — ${m.modality}/${m.taskType}${labels}`);
-      }
+      parts.push('\nLocal models you can run with model_predict (the quoted slug is the modelId). Use one whenever its job matches what you are doing:');
+      for (const m of models.slice(0, 25)) parts.push(describeLocalModel(m));
     }
   } catch {
     /* no local models / store unavailable — skip */