@kynver-app/runtime 0.2.23 → 0.2.24

package/dist/worker-provider-policy.d.ts

@@ -1,6 +1,8 @@
 import type { ModelRoutingDecision } from "./model-routing.js";
-/** Default harness worker CLI provider unless an operator override allows Claude. */
+/** Default harness worker CLI provider when the operator expressed no preference anywhere. */
 export declare const DEFAULT_WORKER_PROVIDER = "cursor";
+/** Normalize an operator-supplied worker provider name to its canonical key. */
+export declare function normalizeWorkerProviderName(name: string): string;
 export declare function isClaudeFamilyProvider(provider: string | null | undefined): boolean;
 /**
  * True when the board row explicitly opts into a Claude/Opus worker
@@ -16,11 +18,26 @@ export interface EnforceCursorWorkerProviderInput {
     explicitProviderIsOperatorOverride?: boolean;
 }
 /**
- * Rewrites Claude/Opus routing to Cursor unless the task or an explicit operator
- * run override allows Claude workers.
+ * True when the board row expresses ANY worker-provider preference (not just
+ * Claude): `workerProviderOverride`, an executorRef `provider:*` intent, or the
+ * Claude override markers handled by {@link taskAllowsClaudeWorker}.
+ */
+export declare function taskExpressesWorkerProviderPreference(task: Record<string, unknown> | null | undefined): boolean;
+/**
+ * W2b routing authority: the Cursor coercion is a *default-only* fallback.
+ * An operator preference expressed anywhere — explicit CLI `--provider`,
+ * explicit CLI model (incl. provider aliases), executorRef provider intent,
+ * factory `provider:*` routing, or task override markers — is authoritative
+ * and never rewritten. Only preference-free Claude-family routing (e.g. the
+ * global default model inferring Claude) is coerced to the Cursor default.
  */
 export declare function enforceCursorWorkerProvider(input: EnforceCursorWorkerProviderInput): ModelRoutingDecision;
-/** Normalize config/registry defaults — legacy `claude` configs map to Cursor unless overridden. */
+/**
+ * Resolve the configured worker provider. W2b: `config.workerProvider` is the
+ * operator's explicit choice and is honored verbatim (after alias
+ * normalization) — the legacy behavior of downgrading Claude-family configs to
+ * Cursor is removed. Only an EMPTY config falls back to the Cursor default.
+ */
 export declare function resolveConfiguredWorkerProvider(configured: string | null | undefined, fallback?: string): string;
 /** Plan / Command Center executor lists — Cursor wins when both families appear. */
 export declare function preferCursorExecutor(executors: string[]): string[];

package/dist/worker-usage.d.ts

@@ -0,0 +1,20 @@
+import type { ParsedStreamUsage } from "./stream.js";
+export interface WorkerUsagePayload {
+    provider: string;
+    model: string | null;
+    inputTokens: number | null;
+    outputTokens: number | null;
+}
+export interface ResolveWorkerUsageInput {
+    /** Usage parsed from the worker's stream output (null/undefined → no payload). */
+    usage?: ParsedStreamUsage | null;
+    /** Provider key frozen at spawn (worker.json), falling back to status readback. */
+    provider?: string | null;
+    /** Launch model from worker.json — used when the stream did not name a model. */
+    model?: string | null;
+}
+/**
+ * Build the completion `workerUsage` payload, or null when the provider
+ * reported no token usage (the field is then omitted from the POST entirely).
+ */
+export declare function resolveWorkerUsagePayload(input: ResolveWorkerUsageInput): WorkerUsagePayload | null;

package/dist/worktree.d.ts

@@ -6,6 +6,39 @@ export interface CreatedRunInfo {
     base: string;
     baseCommit: string;
 }
+export type RunBaseRefSource = "flag" | "env" | "config" | "origin/main" | "remote-head";
+export interface ResolveRunBaseRefInput {
+    /** `--base` on the command line. */
+    explicitBase?: string;
+    /** `KYNVER_RUN_BASE_REF` env override. */
+    envBaseRef?: string;
+    /** `defaultBase` from `~/.kynver/config.json`. */
+    configDefaultBase?: string;
+    /** Verify a ref resolves to a commit in the repo; injectable for tests. */
+    verifyRef: (ref: string) => boolean;
+    /** Resolve the remote default branch (e.g. `origin/master`); injectable for tests. */
+    resolveRemoteHeadRef: () => string | null;
+    /** Repo path for error messages. */
+    repoLabel?: string;
+}
+export interface ResolvedRunBaseRef {
+    base: string;
+    source: RunBaseRefSource;
+    /** Human note when the pick was a fallback (never fall back silently). */
+    note?: string;
+}
+/**
+ * Resolve the base ref a new run is cut from. Precedence: `--base` flag >
+ * `KYNVER_RUN_BASE_REF` env > config `defaultBase` > `origin/main` > the
+ * remote HEAD default branch. An EXPLICIT override (flag/env/config) that
+ * does not verify is an error — never silently substituted with another ref.
+ * When `origin/main` is absent (repos whose default branch is `master`,
+ * `develop`, …) the remote HEAD fallback is used with a visible note; when
+ * nothing resolves the error names everything tried plus the fix.
+ */
+export declare function resolveRunBaseRef(input: ResolveRunBaseRefInput): ResolvedRunBaseRef;
+/** Resolve the remote default branch without hitting `git remote show` (porcelain-free). */
+export declare function resolveRemoteHeadRefForRepo(repo: string): string | null;
 export declare function createRun(args: Record<string, string | boolean>): CreatedRunInfo;
 export declare function listRuns(): void;
 export { loadRun, saveRun, runDirectory };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kynver-app/runtime",
-  "version": "0.2.23",
+  "version": "0.2.24",
   "description": "Kynver AgentOS local execution runtime and CLI",
   "type": "module",
   "main": "./dist/index.js",
@@ -141,7 +141,8 @@
     "build": "esbuild src/cli.ts src/index.ts src/node-runtime-policy.ts src/local-run-store/index.ts src/worker-persona-catalog.ts src/instruction-bundle/contract.ts src/chat/command-auth-proof.ts src/server/monitor.ts src/server/landing.ts src/server/worker-policy.ts src/server/orchestration.ts src/server/adapter-contract.ts src/server/context-budget-receipt.ts src/server/prompt.ts src/server/node-runtime-policy.ts src/server/model-routing.ts src/server/db-credentials.ts src/server/heavy-verification.ts src/server/memory-cost.ts src/server/pr-evidence.ts src/server/default-repo.ts src/server/cleanup.ts src/server/repo-search.ts src/server/harness-notice.ts src/server/memory-cost-enforce.ts src/server/wsl-crash-dumps.ts --bundle --platform=node --format=esm --packages=external --outbase=src --outdir=dist --minify && tsc -p tsconfig.json --emitDeclarationOnly && node scripts/chmod-cli-bin.mjs",
     "typecheck": "tsc -p tsconfig.json --noEmit",
     "test": "vitest run --config vitest.config.ts",
-    "prepublishOnly": "node ../../scripts/npm-publish-guard.mjs && npm run build"
+    "prepublishOnly": "node ../../scripts/npm-publish-guard.mjs && npm run build",
+    "postinstall": "node scripts/postinstall-banner.mjs || true"
   },
   "engines": {
     "node": ">=24.11.0"