@molecule/api-ai-decisions-kev 1.0.0 → 1.0.2

package/README.md

@@ -3,15 +3,11 @@ AUTO-GENERATED — DO NOT EDIT THIS FILE.
 Generated by `mlcl sync-docs` from the package's src/index.ts JSDoc + mlcl/registry.json.
 Edits here are overwritten on the next commit (molecule's pre-commit hook regenerates).
 To change this document, edit the module-level JSDoc in src/index.ts.
-Generated: 2026-10-07T04:32:01.339Z
+Generated: 2026-10-26T04:21:55.720Z
 -->
 
 # @molecule/api-ai-decisions-kev
 
-> **Auto-generated, AI-first package reference** for the [molecule.dev](https://molecule.dev) ecosystem.
-> It is written to be read by coding agents as much as by people, and is generated from this
-> package's source — edit `src/index.ts` JSDoc, not this file.
-
 Kev decisions provider for molecule.dev — typed decisions from the
 open-weights Kev models on a `kev.serve` host you run.
 
@@ -23,6 +19,10 @@ generate no text. Its README recommends Kev-4B as the default. `kev.serve`
 speaks TypeSafe Jev's `/v1/systemone` protocol, so swapping to
 `@molecule/api-ai-decisions-jev`, `-laya` or `-jeff` is a one-line change.
 
+> **Auto-generated, AI-first package reference** for the [molecule.dev](https://molecule.dev) ecosystem.
+> It is written to be read by coding agents as much as by people, and is generated from this
+> package's source — edit `src/index.ts` JSDoc, not this file.
+
 ## Quick Start
 
 ```bash
@@ -104,26 +104,15 @@ interface KevConfig {
 }
 ```
 
-#### `PostOptions`
+#### `WireQuestion`
 
-Options for {@link postSystemOne}.
+One question as sent on the wire.
 
 ```typescript
-interface PostOptions {
-  /** Full endpoint URL. */
-  url: string
-  /** Bearer token, if any. */
-  apiKey?: string
-  /** Extra headers resolved before the request (merged over the defaults). */
-  headers?: () => Record<string, string> | Promise<Record<string, string>>
-  /** Request body. */
-  body: Record<string, unknown>
-  /** Abort signal. */
-  signal?: AbortSignal
-  /** Label for error messages (`'Kev'`). */
-  label: string
-  /** Max retries on a retryable status (default 3). */
-  maxRetries?: number
+interface WireQuestion {
+  type: 'choice' | 'score' | 'noul'
+  instructions: string
+  criteria?: Record<string, string> | string[]
 }
 ```
 
@@ -141,18 +130,6 @@ interface WireAnswer {
 }
 ```
 
-#### `WireQuestion`
-
-One question as sent on the wire.
-
-```typescript
-interface WireQuestion {
-  type: 'choice' | 'score' | 'noul'
-  instructions: string
-  criteria?: Record<string, string> | string[]
-}
-```
-
 #### `WireResponse`
 
 The response body (only the fields we read).
@@ -165,6 +142,29 @@ interface WireResponse {
 }
 ```
 
+#### `PostOptions`
+
+Options for {@link postSystemOne}.
+
+```typescript
+interface PostOptions {
+  /** Full endpoint URL. */
+  url: string
+  /** Bearer token, if any. */
+  apiKey?: string
+  /** Extra headers resolved before the request (merged over the defaults). */
+  headers?: () => Record<string, string> | Promise<Record<string, string>>
+  /** Request body. */
+  body: Record<string, unknown>
+  /** Abort signal. */
+  signal?: AbortSignal
+  /** Label for error messages (`'Kev'`). */
+  label: string
+  /** Max retries on a retryable status (default 3). */
+  maxRetries?: number
+}
+```
+
 ### Functions
 
 #### `createProvider(config)`
@@ -179,6 +179,18 @@ function createProvider(config?: KevConfig): AIDecisionsProvider
 
 **Returns:** An `AIDecisionsProvider` backed by a `kev.serve` host.
 
+#### `toWireQuestions(questions)`
+
+Converts the core's questions into wire questions (`yesNo` → `noul`).
+
+```typescript
+function toWireQuestions(questions: Record<string, DecisionQuestion>): Record<string, WireQuestion>
+```
+
+- `questions` — The questions keyed by id.
+
+**Returns:** The wire `questions` object.
+
 #### `fromWireAnswer(id, question, wire, minConfidence)`
 
 Converts one wire answer into the core's answer for `question`.
@@ -204,7 +216,11 @@ function fromWireAnswer(
 Converts a whole wire response into the core's result.
 
 ```typescript
-function fromWireResponse(questions: Q, body: WireResponse, minConfidence?: number): DecideResult<Q>
+function fromWireResponse<Q extends Record<string, DecisionQuestion>>(
+  questions: Q,
+  body: WireResponse,
+  minConfidence?: number,
+): DecideResult<Q>
 ```
 
 - `questions` — The questions that were asked.
@@ -226,26 +242,22 @@ function postSystemOne(opts: PostOptions): Promise<WireResponse>
 
 **Returns:** The parsed response body.
 
-#### `toWireQuestions(questions)`
+### Constants
 
-Converts the core's questions into wire questions (`yesNo` → `noul`).
+#### `DEFAULT_KEV_URL`
+
+`kev.serve`'s default bind (`--port` defaults to 8008; its README examples use 8009).
 
 ```typescript
-function toWireQuestions(questions: Record<string, DecisionQuestion>): Record<string, WireQuestion>
+const DEFAULT_KEV_URL: 'http://localhost:8008'
 ```
 
-- `questions` — The questions keyed by id.
-
-**Returns:** The wire `questions` object.
-
-### Constants
-
-#### `aiDecisionsKevSecretDefinitions`
+#### `DEFAULT_KEV_MODEL`
 
-Secret definitions used by the Kev decisions bond.
+The model id `kev.serve` documents; any string is echoed back, none selects a checkpoint.
 
 ```typescript
-const aiDecisionsKevSecretDefinitions: SecretDefinition[]
+const DEFAULT_KEV_MODEL: 'kev-latest'
 ```
 
 #### `DEFAULT_KEV_MAX_OPTIONS`
@@ -256,14 +268,6 @@ Most `choice` options or `score` levels `kev.serve` accepts (`MAX_OPTIONS` in `k
 const DEFAULT_KEV_MAX_OPTIONS: 255
 ```
 
-#### `DEFAULT_KEV_MODEL`
-
-The model id `kev.serve` documents; any string is echoed back, none selects a checkpoint.
-
-```typescript
-const DEFAULT_KEV_MODEL: 'kev-latest'
-```
-
 #### `DEFAULT_KEV_TIMEOUT_MS`
 
 Default per-call timeout: room for a scale-to-zero cold start (~35 s on Modal).
@@ -272,20 +276,20 @@ Default per-call timeout: room for a scale-to-zero cold start (~35 s on Modal).
 const DEFAULT_KEV_TIMEOUT_MS: 120000
 ```
 
-#### `DEFAULT_KEV_URL`
+#### `provider`
 
-`kev.serve`'s default bind (`--port` defaults to 8008; its README examples use 8009).
+The provider implementation — lazy, so env vars are read on first use.
 
 ```typescript
-const DEFAULT_KEV_URL: 'http://localhost:8008'
+const provider: AIDecisionsProvider
 ```
 
-#### `provider`
+#### `aiDecisionsKevSecretDefinitions`
 
-The provider implementation — lazy, so env vars are read on first use.
+Secret definitions used by the Kev decisions bond.
 
 ```typescript
-const provider: AIDecisionsProvider
+const aiDecisionsKevSecretDefinitions: SecretDefinition[]
 ```
 
 ## Core Interface

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@molecule/api-ai-decisions-kev",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Kev decisions provider for molecule.dev — typed choice/score/yes-no answers from the open-weights Kev models (Qwen-based, 0.8B–27B) on your own kev.serve host",
   "type": "module",
   "main": "dist/index.js",
@@ -35,11 +35,11 @@
     "@molecule/api-secrets": "^1.0.1"
   },
   "devDependencies": {
-    "@molecule/api-ai-decisions": "1.1.1",
+    "@molecule/api-ai-decisions": "1.1.2",
     "@molecule/api-secrets": "1.0.2",
-    "@types/node": "26.1.2",
+    "@types/node": "26.6.5",
     "typescript": "6.0.3",
-    "vitest": "4.1.11"
+    "vitest": "4.1.12"
   },
   "repository": {
     "type": "git",