@kindgi/cli 0.1.4-rc.2 → 0.1.4-rc.4

package/dist/providers/preset-loader.js

@@ -6,8 +6,9 @@
  * A preset is a vendor's registration body with the models, context
  * windows and prices filled in (`src/providers/presets/<name>.json`,
  * copied to `dist/providers/presets/` at build): its adapter, the secret
- * its credential lives in (if any), the adapter settings it needs from
- * the caller (e.g. Gemini's `--project`), and `metadata`. Prices change
+ * its credential lives in (if any), the adapter settings it fixes itself
+ * (e.g. an OpenAI-compatible endpoint's `baseURL`) or needs from the
+ * caller (e.g. Gemini's `--project`), and `metadata`. Prices change
  * with the vendors' — `pricesCheckedAt` says when they were last read.
  */
 import { readFile as nodeReadFile, readdir as nodeReaddir } from 'node:fs/promises';
@@ -56,14 +57,9 @@ function checkPreset(input) {
     if (p.secret !== undefined && (typeof p.secret !== 'string' || p.secret === '')) {
         return '"secret" must be a non-empty string';
     }
-    if (p.adapterConfig !== undefined &&
-        (!Array.isArray(p.adapterConfig) ||
-            !p.adapterConfig.every((s) => s !== null &&
-                typeof s === 'object' &&
-                typeof s.key === 'string' &&
-                typeof s.description === 'string'))) {
-        return '"adapterConfig" must be a list of { key, description }';
-    }
+    const configProblem = adapterConfigProblem(p);
+    if (configProblem !== undefined)
+        return configProblem;
     const metadata = p.metadata;
     if (metadata === undefined ||
         typeof metadata.id !== 'string' ||
@@ -74,6 +70,26 @@ function checkPreset(input) {
     }
     return input;
 }
+/** What's wrong with a preset's `adapterConfig` / `adapterConfigValues`, if anything. */
+function adapterConfigProblem(p) {
+    if (p.adapterConfig !== undefined &&
+        (!Array.isArray(p.adapterConfig) ||
+            !p.adapterConfig.every((s) => s !== null &&
+                typeof s === 'object' &&
+                typeof s.key === 'string' &&
+                typeof s.description === 'string'))) {
+        return '"adapterConfig" must be a list of { key, description }';
+    }
+    const values = p.adapterConfigValues;
+    if (values !== undefined &&
+        (values === null ||
+            typeof values !== 'object' ||
+            Array.isArray(values) ||
+            !Object.values(values).every((v) => ['string', 'number', 'boolean'].includes(typeof v)))) {
+        return '"adapterConfigValues" must be an object of string, number or boolean values';
+    }
+    return undefined;
+}
 /** The registration body for a preset, or why the choices don't fit it. */
 export function presetRegistration(preset, choices) {
     const all = preset.metadata.models;
@@ -101,7 +117,10 @@ export function presetRegistration(preset, choices) {
         };
     }
     const secret = choices.secret ?? preset.secret;
-    const adapterConfig = Object.fromEntries((preset.adapterConfig ?? []).map((s) => [s.key, choices.settings[s.key]]));
+    const adapterConfig = {
+        ...preset.adapterConfigValues,
+        ...Object.fromEntries((preset.adapterConfig ?? []).map((s) => [s.key, choices.settings[s.key]])),
+    };
     return {
         kind: 'ok',
         input: {

package/dist/providers/preset-loader.js.map

@@ -1 +1 @@
-{"version":3,"file":"preset-loader.js","sourceRoot":"","sources":["../../src/providers/preset-loader.ts"],"names":[],"mappings":"AAAA,sCAAsC;AACtC,iCAAiC;AAEjC;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,IAAI,YAAY,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpF,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AA0BzC,MAAM,SAAS,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AAE1D,MAAM,UAAU,0BAA0B;IACxC,OAAO,IAAI,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;AACpC,CAAC;AAOD,MAAM,UAAU,GAAa;IAC3B,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC;IAC1C,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC;CACrD,CAAC;AAEF,+EAA+E;AAC/E,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,MAAc,0BAA0B,EAAE,EAC1C,KAAe,UAAU;IAEzB,MAAM,KAAK,GAAG,CAAC,MAAM,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAChF,MAAM,OAAO,GAAmC,EAAE,CAAC;IACnD,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,CAAC,OAAe,EAAS,EAAE,CAAC,IAAI,KAAK,CAAC,mBAAmB,IAAI,KAAK,OAAO,EAAE,CAAC,CAAC;QAC7F,IAAI,MAAe,CAAC;QACpB,IAAI,CAAC;YACH,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QAC1D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,CAAC,kBAAmB,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAC5D,CAAC;QACD,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QACnC,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;QACtD,IAAI,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,EAAE,CAAC;YAChD,MAAM,OAAO,CAAC,SAAS,MAAM,CAAC,IAAI,gCAAgC,CAAC,CAAC;QACtE,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC;IAChC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,WAAW,CAAC,KAAc;IACjC,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,OAAO,uBAAuB,CAAC;IACjC,CAAC;IACD,MAAM,CAAC,GAAG,KAAgC,CAAC;IAC3C,KAAK,MAAM,GAAG,IAAI,CAAC,MAAM,EAAE,aAAa,EAAE,WAAW,EAAE,iBAAiB,CAAU,EAAE,CAAC;QACnF,IAAI,OAAO,CAAC,CAAC,GAAG,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE;YAAE,OAAO,IAAI,GAAG,8BAA8B,CAAC;IAChG,CAAC;IACD,IAAI,CAAC,CAAC,MAAM,KAAK,SAAS,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,KAAK,EAAE,CAAC,EAAE,CAAC;QAChF,OAAO,qCAAqC,CAAC;IAC/C,CAAC;IACD,IACE,CAAC,CAAC,aAAa,KAAK,SAAS;QAC7B,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,CAAC;YAC9B,CAAC,CAAC,CAAC,aAAa,CAAC,KAAK,CACpB,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,KAAK,IAAI;gBACV,OAAO,CAAC,KAAK,QAAQ;gBACrB,OAAQ,CAAmB,CAAC,GAAG,KAAK,QAAQ;gBAC5C,OAAQ,CAAmB,CAAC,WAAW,KAAK,QAAQ,CACvD,CAAC,EACJ,CAAC;QACD,OAAO,wDAAwD,CAAC;IAClE,CAAC;IACD,MAAM,QAAQ,GAAG,CAAC,CAAC,QAA4E,CAAC;IAChG,IACE,QAAQ,KAAK,SAAS;QACtB,OAAO,QAAQ,CAAC,EAAE,KAAK,QAAQ;QAC/B,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;QAC/B,QAAQ,CAAC,MAAM,CAAC,MAAM,KAAK,CAAC;QAC5B,CAAC,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAQ,CAAwB,CAAC,IAAI,KAAK,QAAQ,CAAC,EACjF,CAAC;QACD,OAAO,yDAAyD,CAAC;IACnE,CAAC;IACD,OAAO,KAAuB,CAAC;AACjC,CAAC;AAkBD,2EAA2E;AAC3E,MAAM,UAAU,kBAAkB,CAChC,MAAsB,EACtB,OAAsB;IAOtB,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;IACnC,MAAM,OAAO,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC;IAC3F,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,WAAW,MAAM,CAAC,IAAI,kBAAkB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;SACpH,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GACV,OAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;IAC3F,MAAM,GAAG,GAAG,OAAO,CAAC,eAAe,CAAC;IACpC,IAAI,GAAG,KAAK,SAAS,IAAI,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,EAAE,CAAC;QAC7D,OAAO;YACL,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,iEAAiE,GAAG,EAAE;SAChF,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,eAAe,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IAChG,MAAM,OAAO,GAAG,CAAC,MAAM,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,CAAC;IAClG,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO;YACL,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,WAAW,MAAM,CAAC,IAAI,WAAW,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,SAAS,CAAC,CAAC,WAAW,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;SAC/G,CAAC;IACJ,CAAC;IACD,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,CAAC;IAC/C,MAAM,aAAa,GAAG,MAAM,CAAC,WAAW,CACtC,CAAC,MAAM,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAW,CAAC,CAAC,CACpF,CAAC;IACF,OAAO;QACL,IAAI,EAAE,IAAI;QACV,KAAK,EAAE;YACL,QAAQ,EAAE,EAAE,GAAG,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE;YACxC,UAAU,EAAE,MAAM,CAAC,SAAS;YAC5B,GAAG,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,CAAC;YACvF,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,cAAc,EAAE,aAAa,EAAE,CAAC;SAChF;KACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"preset-loader.js","sourceRoot":"","sources":["../../src/providers/preset-loader.ts"],"names":[],"mappings":"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"}

package/dist/providers/presets/gemini-api.json

@@ -0,0 +1,55 @@
+{
+  "name": "gemini-api",
+  "description": "Gemini on the Gemini Developer API, with an API key from Google AI Studio (key: GEMINI_API_KEY). For Vertex AI, use gemini.",
+  "adapterId": "@kindgi/adapter-model-gemini",
+  "adapterConfigValues": {
+    "api": "developer"
+  },
+  "secret": "GEMINI_API_KEY",
+  "pricesCheckedAt": "2026-10-07",
+  "metadata": {
+    "id": "gemini-api",
+    "region": "unspecified",
+    "description": "Gemini on the Gemini Developer API",
+    "models": [
+      {
+        "name": "gemini-3.8-flash",
+        "contextWindow": 1048576,
+        "maxOutputTokens": 65536,
+        "features": ["tool-use", "long-context"],
+        "cost": {
+          "promptUsdPer1kTokens": 0.00075,
+          "completionUsdPer1kTokens": 0.00375
+        },
+        "description": "Fast and inexpensive (Google's prices for it rise on 2027-01-01)."
+      },
+      {
+        "name": "gemini-3.1-pro-preview",
+        "contextWindow": 1048576,
+        "maxOutputTokens": 65536,
+        "features": ["tool-use", "long-context"],
+        "cost": {
+          "promptUsdPer1kTokens": 0.002,
+          "completionUsdPer1kTokens": 0.012,
+          "longContext": {
+            "thresholdTokens": 200000,
+            "promptUsdPer1kTokens": 0.004,
+            "completionUsdPer1kTokens": 0.018
+          }
+        },
+        "description": "Most capable Gemini (a preview model)."
+      },
+      {
+        "name": "gemini-3.5-flash-lite",
+        "contextWindow": 1048576,
+        "maxOutputTokens": 65536,
+        "features": ["tool-use", "long-context"],
+        "cost": {
+          "promptUsdPer1kTokens": 0.0003,
+          "completionUsdPer1kTokens": 0.0025
+        },
+        "description": "Cheapest — routing, classification, simple calls."
+      }
+    ]
+  }
+}

package/dist/providers/presets/groq.json

@@ -0,0 +1,39 @@
+{
+  "name": "groq",
+  "description": "Open-weight models on Groq's fast inference (key: GROQ_API_KEY).",
+  "adapterId": "@kindgi/adapter-model-openai-compat",
+  "adapterConfigValues": {
+    "baseURL": "https://api.groq.com/openai/v1"
+  },
+  "secret": "GROQ_API_KEY",
+  "pricesCheckedAt": "2026-10-07",
+  "metadata": {
+    "id": "groq",
+    "region": "unspecified",
+    "description": "Open-weight models on Groq",
+    "models": [
+      {
+        "name": "openai/gpt-oss-120b",
+        "contextWindow": 131072,
+        "maxOutputTokens": 65536,
+        "features": ["tool-use"],
+        "cost": {
+          "promptUsdPer1kTokens": 0.00015,
+          "completionUsdPer1kTokens": 0.0006
+        },
+        "description": "gpt-oss 120B: the stronger of the two."
+      },
+      {
+        "name": "openai/gpt-oss-20b",
+        "contextWindow": 131072,
+        "maxOutputTokens": 65536,
+        "features": ["tool-use"],
+        "cost": {
+          "promptUsdPer1kTokens": 7.5e-5,
+          "completionUsdPer1kTokens": 0.0003
+        },
+        "description": "gpt-oss 20B: fastest and cheapest."
+      }
+    ]
+  }
+}

package/dist/providers/presets/openai.json

@@ -0,0 +1,50 @@
+{
+  "name": "openai",
+  "description": "GPT on the OpenAI API (key: OPENAI_API_KEY).",
+  "adapterId": "@kindgi/adapter-model-openai-compat",
+  "adapterConfigValues": {
+    "baseURL": "https://api.openai.com/v1"
+  },
+  "secret": "OPENAI_API_KEY",
+  "pricesCheckedAt": "2026-10-07",
+  "metadata": {
+    "id": "openai",
+    "region": "unspecified",
+    "description": "GPT on the OpenAI API",
+    "models": [
+      {
+        "name": "gpt-6.1-sol",
+        "contextWindow": 1050000,
+        "maxOutputTokens": 128000,
+        "features": ["tool-use", "parallel-tool-use", "structured-output", "long-context"],
+        "cost": {
+          "promptUsdPer1kTokens": 0.002,
+          "completionUsdPer1kTokens": 0.01
+        },
+        "description": "Balanced performance and cost."
+      },
+      {
+        "name": "gpt-6-astra",
+        "contextWindow": 1050000,
+        "maxOutputTokens": 128000,
+        "features": ["tool-use", "parallel-tool-use", "structured-output", "long-context"],
+        "cost": {
+          "promptUsdPer1kTokens": 0.01,
+          "completionUsdPer1kTokens": 0.05
+        },
+        "description": "Most capable — hard reasoning and long agentic work."
+      },
+      {
+        "name": "gpt-6-luna",
+        "contextWindow": 1050000,
+        "maxOutputTokens": 128000,
+        "features": ["tool-use", "parallel-tool-use", "structured-output", "long-context"],
+        "cost": {
+          "promptUsdPer1kTokens": 0.0001,
+          "completionUsdPer1kTokens": 0.0005
+        },
+        "description": "Fastest and cheapest — routing, classification, simple calls."
+      }
+    ]
+  }
+}

package/dist/providers/presets/openrouter.json

@@ -0,0 +1,61 @@
+{
+  "name": "openrouter",
+  "description": "Many vendors' models through OpenRouter, with one key (key: OPENROUTER_API_KEY).",
+  "adapterId": "@kindgi/adapter-model-openai-compat",
+  "adapterConfigValues": {
+    "baseURL": "https://openrouter.ai/api/v1"
+  },
+  "secret": "OPENROUTER_API_KEY",
+  "pricesCheckedAt": "2026-10-07",
+  "metadata": {
+    "id": "openrouter",
+    "region": "unspecified",
+    "description": "Models from several vendors through OpenRouter",
+    "models": [
+      {
+        "name": "anthropic/claude-sonnet-5.5",
+        "contextWindow": 1000000,
+        "maxOutputTokens": 128000,
+        "features": ["tool-use", "parallel-tool-use", "structured-output", "long-context"],
+        "cost": {
+          "promptUsdPer1kTokens": 0.002,
+          "completionUsdPer1kTokens": 0.01
+        },
+        "description": "Claude Sonnet 5.5: balanced performance and cost."
+      },
+      {
+        "name": "openai/gpt-6.1-sol",
+        "contextWindow": 1050000,
+        "maxOutputTokens": 128000,
+        "features": ["tool-use", "parallel-tool-use", "structured-output", "long-context"],
+        "cost": {
+          "promptUsdPer1kTokens": 0.002,
+          "completionUsdPer1kTokens": 0.01
+        },
+        "description": "GPT-6.1 Sol: balanced performance and cost."
+      },
+      {
+        "name": "google/gemini-3.8-flash",
+        "contextWindow": 1048576,
+        "maxOutputTokens": 65536,
+        "features": ["tool-use", "parallel-tool-use", "structured-output", "long-context"],
+        "cost": {
+          "promptUsdPer1kTokens": 0.00075,
+          "completionUsdPer1kTokens": 0.00375
+        },
+        "description": "Gemini 3.8 Flash: fast and inexpensive."
+      },
+      {
+        "name": "openai/gpt-6-luna",
+        "contextWindow": 1050000,
+        "maxOutputTokens": 128000,
+        "features": ["tool-use", "parallel-tool-use", "structured-output", "long-context"],
+        "cost": {
+          "promptUsdPer1kTokens": 0.0001,
+          "completionUsdPer1kTokens": 0.0005
+        },
+        "description": "GPT-6 Luna: fastest and cheapest — routing, classification, simple calls."
+      }
+    ]
+  }
+}

package/dist/sdk-skills/kindgi-authoring-agents/SKILL.md

@@ -13,7 +13,7 @@ description: >
 type: core
 library: "@kindgi/sdk"
 version: "0.4.2"
-sdk_version: "0.1.4-rc.2"
+sdk_version: "0.1.4-rc.4"
 pack_languages: [node]
 sources:
   - packages/agents/src/types.ts

package/dist/sdk-skills/kindgi-authoring-flows/SKILL.md

@@ -14,7 +14,7 @@ description: >
 type: core
 library: "@kindgi/sdk"
 version: "0.1.2"
-sdk_version: "0.1.4-rc.2"
+sdk_version: "0.1.4-rc.4"
 pack_languages: [node]
 sources:
   - packages/flow/src/types.ts

package/dist/sdk-skills/kindgi-authoring-guardrails/SKILL.md

@@ -16,7 +16,7 @@ description: >
 type: core
 library: "@kindgi/sdk"
 version: "0.3.6"
-sdk_version: "0.1.4-rc.2"
+sdk_version: "0.1.4-rc.4"
 pack_languages: [node]
 sources:
   - packages/guardrails/src/types.ts

package/dist/sdk-skills/kindgi-authoring-mcp-servers/SKILL.md

@@ -18,7 +18,7 @@ description: >
 type: core
 library: "@kindgi/sdk"
 version: "0.3.0"
-sdk_version: "0.1.4-rc.2"
+sdk_version: "0.1.4-rc.4"
 pack_languages: [node, python]
 ---
 

package/dist/sdk-skills/kindgi-authoring-providers/SKILL.md

@@ -22,8 +22,8 @@ description: >
   kindgi-getting-started.
 type: core
 library: "@kindgi/sdk"
-version: "0.9.3"
-sdk_version: "0.1.4-rc.2"
+version: "0.9.4"
+sdk_version: "0.1.4-rc.4"
 pack_languages: [node, python]
 sources:
   - packages/adapters/model-anthropic/src/provider.ts
@@ -305,15 +305,23 @@ kindgi secrets set GROQ_API_KEY --env=local --scope=tenant
 
 **Steps 3–5** same as Path A.
 
-## Path C — Local via in-process ONNX
+## Path C — Local via in-process ONNX (runtime from source only)
+
+> ⚠️ **Not in the runtime image, so not under `kindgi dev`.** The adapter
+> runs ONNX through `onnxruntime-node`, which ships glibc binaries only,
+> and the Kindgi runtime image is Alpine (musl): the adapter can't load
+> there (`Error loading shared library ld-linux-…`). `kindgi dev` runs
+> that image, so this path fails under it. It works only when the
+> runtime itself runs from source on macOS or a glibc Linux. **For a
+> local model under `kindgi dev`, use Ollama** ([Local via Ollama](#local-via-ollama-via-path-b)).
 
 > ⚠️ **Dev-only.** The in-process ONNX adapter writes weights to
 > `~/.cache/huggingface/hub/` — a per-machine cache with no production
 > recipe (no volume-mount recipe, no image-bake pattern, no offline
-> mode, no SHA pinning). Good for local dev, smoke tests, and CI
-> runners that keep the same disk between runs. **Do not ship packs
-> that rely on this adapter to production.** Use hosted providers
-> (Path A) or Ollama (Path B) instead.
+> mode, no SHA pinning). Good for smoke tests and CI runners that run
+> the runtime from source and keep the same disk between runs. **Do not
+> ship packs that rely on this adapter to production.** Use hosted
+> providers (Path A) or Ollama (Path B) instead.
 
 No API key. No network. Bundled with the framework — the adapter ships
 `smollm2-360m` by default (~273 MB weights, cached at
@@ -385,7 +393,8 @@ production. Skip only for scripted teardown where the model is already
 cached (`~/.cache/huggingface/hub/models--HuggingFaceTB--SmolLM2-360M-Instruct/`).
 
 `prepare` is idempotent: subsequent invocations are cache hits and
-return almost instantly, so put it in every `kindgi dev` boot script.
+return almost instantly, so put it in the script that boots your
+from-source runtime.
 
 Multi-model providers: prepare each model separately.
 ```sh

package/dist/sdk-skills/kindgi-authoring-tools/SKILL.md

@@ -13,7 +13,7 @@ description: >
 type: core
 library: "@kindgi/sdk"
 version: "0.4.4"
-sdk_version: "0.1.4-rc.2"
+sdk_version: "0.1.4-rc.4"
 pack_languages: [node]
 sources:
   - packages/tools/src/types.ts

package/dist/sdk-skills/kindgi-framework-feedback/SKILL.md

@@ -15,7 +15,7 @@ description: >
 type: core
 library: "@kindgi/sdk"
 version: "0.4.0"
-sdk_version: "0.1.4-rc.2"
+sdk_version: "0.1.4-rc.4"
 pack_languages: [node, python]
 ---
 

package/dist/sdk-skills/kindgi-getting-started/SKILL.md

@@ -15,7 +15,7 @@ description: >
 type: core
 library: "@kindgi/sdk"
 version: "0.3.8"
-sdk_version: "0.1.4-rc.2"
+sdk_version: "0.1.4-rc.4"
 pack_languages: [node]
 ---
 

package/dist/sdk-skills/kindgi-python-authoring-agents/SKILL.md

@@ -15,8 +15,8 @@ description: >
   model by kindgi-authoring-providers.
 type: core
 library: "kindgi (Python)"
-version: "0.1.0"
-sdk_version: "0.1.4-rc.2"
+version: "0.1.1"
+sdk_version: "0.1.4-rc.4"
 pack_languages: [python]
 sources:
   - sdks/python/src/kindgi/pack/define.py
@@ -25,9 +25,11 @@ sources:
 
 # Authoring Kindgi agents in Python
 
-> **Running `kindgi`:** a Python pack has no Node project, so the
-> `kindgi` CLI is the one on `PATH`. Python commands run in the pack's
-> environment: `uv run …` (or `.venv/bin/python …`).
+> **Running `kindgi`:** the CLI is `kindgi-cli` from PyPI, pinned in the
+> pack's dev group, so every `kindgi <command>` below runs as
+> `uv run kindgi <command>` (Poetry: `poetry run kindgi <command>`). Python
+> commands run in the pack's environment the same way: `uv run …` (or
+> `.venv/bin/python …`).
 
 An **agent** is a versioned, model-driven orchestrator: instructions (a
 prompt template), the tools it may call, the capabilities its model

package/dist/sdk-skills/kindgi-python-authoring-flows/SKILL.md

@@ -16,8 +16,8 @@ description: >
   kindgi-python-authoring-agents.
 type: core
 library: "kindgi (Python)"
-version: "0.1.1"
-sdk_version: "0.1.4-rc.2"
+version: "0.1.2"
+sdk_version: "0.1.4-rc.4"
 pack_languages: [python]
 sources:
   - sdks/python/src/kindgi/pack/define.py
@@ -27,9 +27,11 @@ sources:
 
 # Authoring Kindgi flows in Python
 
-> **Running `kindgi`:** a Python pack has no Node project, so the
-> `kindgi` CLI is the one on `PATH`. Python commands run in the pack's
-> environment: `uv run …` (or `.venv/bin/python …`).
+> **Running `kindgi`:** the CLI is `kindgi-cli` from PyPI, pinned in the
+> pack's dev group, so every `kindgi <command>` below runs as
+> `uv run kindgi <command>` (Poetry: `poetry run kindgi <command>`). Python
+> commands run in the pack's environment the same way: `uv run …` (or
+> `.venv/bin/python …`).
 
 A **flow** is a versioned, durable graph of steps: tools (your code) and
 agents (a model's judgment), joined by edges that can carry conditions.

package/dist/sdk-skills/kindgi-python-authoring-guardrails/SKILL.md

@@ -14,8 +14,8 @@ description: >
   kindgi-python-authoring-tools.
 type: core
 library: "kindgi (Python)"
-version: "0.1.1"
-sdk_version: "0.1.4-rc.2"
+version: "0.1.2"
+sdk_version: "0.1.4-rc.4"
 pack_languages: [python]
 sources:
   - sdks/python/src/kindgi/pack/define.py
@@ -25,9 +25,11 @@ sources:
 
 # Authoring Kindgi guardrails in Python
 
-> **Running `kindgi`:** a Python pack has no Node project, so the
-> `kindgi` CLI is the one on `PATH`. Python commands run in the pack's
-> environment: `uv run …` (or `.venv/bin/python …`).
+> **Running `kindgi`:** the CLI is `kindgi-cli` from PyPI, pinned in the
+> pack's dev group, so every `kindgi <command>` below runs as
+> `uv run kindgi <command>` (Poetry: `poetry run kindgi <command>`). Python
+> commands run in the pack's environment the same way: `uv run …` (or
+> `.venv/bin/python …`).
 
 A **guardrail** is a rule an agent's turn must satisfy: a **check** (a
 function over the turn's trace) plus an **action** (what happens when it

package/dist/sdk-skills/kindgi-python-authoring-tools/SKILL.md

@@ -14,8 +14,8 @@ description: >
   kindgi-python-getting-started.
 type: core
 library: "kindgi (Python)"
-version: "0.1.1"
-sdk_version: "0.1.4-rc.2"
+version: "0.1.2"
+sdk_version: "0.1.4-rc.4"
 pack_languages: [python]
 sources:
   - sdks/python/src/kindgi/pack/define.py
@@ -25,9 +25,11 @@ sources:
 
 # Authoring Kindgi tools in Python
 
-> **Running `kindgi`:** a Python pack has no Node project, so the
-> `kindgi` CLI is the one on `PATH`. Python commands run in the pack's
-> environment: `uv run …` (or `.venv/bin/python …`).
+> **Running `kindgi`:** the CLI is `kindgi-cli` from PyPI, pinned in the
+> pack's dev group, so every `kindgi <command>` below runs as
+> `uv run kindgi <command>` (Poetry: `poetry run kindgi <command>`). Python
+> commands run in the pack's environment the same way: `uv run …` (or
+> `.venv/bin/python …`).
 
 A **tool** is a unit of work an agent (or a flow step) calls: typed
 input, typed output, your code in between. In a Python pack it is a

package/dist/sdk-skills/kindgi-python-getting-started/SKILL.md

@@ -14,8 +14,8 @@ description: >
   kindgi-python-authoring-agents; models by kindgi-authoring-providers.
 type: core
 library: "kindgi (Python)"
-version: "0.1.5"
-sdk_version: "0.1.4-rc.2"
+version: "0.1.6"
+sdk_version: "0.1.4-rc.4"
 pack_languages: [python]
 sources:
   - sdks/python/README.md
@@ -25,9 +25,11 @@ sources:
 
 # Getting started with Kindgi in Python
 
-> **Running `kindgi`:** a Python pack has no Node project, so the
-> `kindgi` CLI (a Node 22.12+ program) is the one on `PATH`. Python
-> commands run in the pack's environment: `uv run …`.
+> **Running `kindgi`:** the CLI is `kindgi-cli` from PyPI (the Kindgi CLI
+> with its own Node, so no Node install), pinned in the pack's dev group.
+> Every `kindgi <command>` below runs as `uv run kindgi <command>` (Poetry:
+> `poetry run kindgi <command>`). Python commands run in the pack's
+> environment the same way: `uv run …`.
 
 ## What a pack is
 
@@ -52,11 +54,11 @@ primitive; `test_*.py`, `*_test.py` and `conftest.py` are skipped.
 ## Scaffold a new pack
 
 ```sh
-kindgi init my-pack --template=python
+uvx --from "kindgi-cli>=0.1,<0.2" kindgi init my-pack --template=python
 cd my-pack
-uv sync            # .venv with the kindgi package
+uv sync            # .venv with the kindgi package and the kindgi CLI
 uv run pytest
-kindgi dev         # boots Kindgi locally and runs this pack, reloading on save
+uv run kindgi dev  # boots Kindgi locally and runs this pack, reloading on save
 ```
 
 `kindgi dev` needs Postgres: it starts one in Docker unless
@@ -70,9 +72,10 @@ kindgi dev         # boots Kindgi locally and runs this pack, reloading on save
 In the app's directory (where its `pyproject.toml` is):
 
 ```sh
-kindgi init            # --pack-id=<id> if the app's name doesn't make one
+uv add --dev "kindgi-cli>=0.1,<0.2"   # the CLI (Poetry: poetry add --group dev …)
+uv run kindgi init     # --pack-id=<id> if the app's name doesn't make one
 uv sync                # or what it prints for Poetry / pip
-kindgi dev
+uv run kindgi dev
 ```
 
 `kindgi init` edits the app's `pyproject.toml` in place — your layout and
@@ -116,7 +119,7 @@ The `[tool.kindgi]` keys are the ones `kindgi.config.ts` takes —
 With `kindgi dev` running, from another terminal in the pack directory:
 
 ```sh
-kindgi runs start --agent=my-pack.echo-agent --input='{"userMessage":"Ada"}'
+uv run kindgi runs start --agent=my-pack.echo-agent --input='{"userMessage":"Ada"}'
 ```
 
 The answer comes from `dev-echo`, a **fallback** provider a new pack
@@ -125,8 +128,8 @@ responded: …", and the turn carries a `fallback-provider` warning. For
 a real model, put the key in `.env` and register a provider:
 
 ```sh
-kindgi secrets set ANTHROPIC_API_KEY --env=local --scope=tenant   # no-echo prompt
-kindgi providers register --preset=anthropic
+uv run kindgi secrets set ANTHROPIC_API_KEY --env=local --scope=tenant   # no-echo prompt
+uv run kindgi providers register --preset=anthropic
 ```
 
 It takes over at the next turn. That registration is in this project's dev

package/dist/templates/minimal/AGENTS.md

@@ -7,9 +7,12 @@ field-level docs. Iterate with `kindgi dev`; `kindgi --help` lists
 the full CLI.
 
 Agents answer through a model provider. `kindgi dev` gives a new pack
-`dev-echo`, a fallback that calls the first tool and replies
-"Tool responded: …" while no other provider fits. For Claude,
-put the key in `.env` and declare `{ preset: 'anthropic' }` in
+`dev-echo`, a fallback that isn't a model: it calls the first tool and
+replies "Tool responded: …" after a warning line, while no other provider
+fits. For a real model, put one LLM provider's key in `.env`
+(`ANTHROPIC_API_KEY`, `OPENAI_API_KEY`, `GEMINI_API_KEY`, `GROQ_API_KEY` or
+`OPENROUTER_API_KEY`) and declare its preset (`{ preset: 'anthropic' }`,
+`'openai'`, `'gemini-api'`, `'groq'` or `'openrouter'`) in
 `kindgi.config.ts`'s `providers`: `kindgi dev` then registers it on every
 boot, in every worktree. Other providers and per-agent model choice:
 `.claude/skills/kindgi-authoring-providers/SKILL.md`.