@kynver-app/runtime 0.2.19 → 0.2.24

package/dist/landing/land-pr-check-classify.d.ts

@@ -7,5 +7,11 @@ export declare function classifyChecks(statusCheckRollup: unknown[] | undefined)
     failed: string[];
     ignoredActions: string[];
 };
+/**
+ * LEGACY (Vercel decommissioned 2026-08): no check named `vercel*` appears on
+ * current PRs, so this always returns false post-cutover. Retained so landing
+ * evidence for pre-cutover PRs still classifies; callers treat it as one
+ * optional evidence source among several.
+ */
 export declare function vercelCheckSuccess(statusCheckRollup: unknown[] | undefined): boolean;
 export declare function mergeStateReadinessError(mergeStateStatus: string, checks: ReturnType<typeof classifyChecks>): string | null;

package/dist/orchestration-providers/inventory.d.ts

@@ -2,19 +2,42 @@ import { type CodexOrchestrationPath } from "./codex-orchestration-adapter.js";
 import { type HermesCliAdapterStatus } from "./hermes-cli-adapter.js";
 import { type HermesOpenAiCodexBindingStatus } from "./hermes-openai-codex-binding.js";
 import type { OrchestrationProviderBindingStatus, OrchestrationProviderId } from "./types.js";
+/**
+ * PRESENCE-ONLY report of cloud API keys on the daemon host env.
+ *
+ * Honesty note (model-freedom audit gap 8): these keys are NOT usable by
+ * harness CLI workers — the worker-env scrub (`worker-env.ts`) strips every
+ * `*_API_KEY` from worker child environments by design. Presence here means
+ * only "the key exists on the daemon host" (e.g. for daemon-side HTTP paths);
+ * it must never be advertised as spendable worker credit.
+ */
 export interface OrchestrationCloudApiCredits {
-    /** ANTHROPIC_API_KEY configured on host (cloud billing — not BYO OAuth). */
+    /** ANTHROPIC_API_KEY present on the daemon host env (scrubbed from worker children). */
     anthropicApiKey: boolean;
-    /** OPENAI_API_KEY configured on host (cloud billing — distinct from Codex OAuth). */
+    /** OPENAI_API_KEY present on the daemon host env (scrubbed from worker children). */
     openaiApiKey: boolean;
-    /** CODEX_API_KEY configured on host (OpenAI Codex cloud path). */
+    /** CODEX_API_KEY present on the daemon host env (scrubbed from worker children). */
     codexApiKey: boolean;
 }
+/**
+ * W2a — generic `openai-compatible` worker provider endpoint presence.
+ * Unlike the cloud API keys above, this path IS worker-usable: the daemon
+ * builds the request (headers include the key) and hands it to its own runner
+ * child over stdin, so the scrub never blocks it.
+ */
+export interface OrchestrationWorkerEndpoint {
+    /** KYNVER_WORKER_BASE_URL present — the generic provider is endpoint-configured. */
+    baseUrlConfigured: boolean;
+    /** KYNVER_WORKER_API_KEY present (optional — many local servers need none). */
+    apiKeyConfigured: boolean;
+}
 export interface OrchestrationProviderInventory {
     generatedAt: string;
     bindings: Record<OrchestrationProviderId, OrchestrationProviderBindingStatus>;
-    /** API-key cloud paths — separate from local OAuth CLI sessions. */
+    /** API-key PRESENCE on the daemon host — not worker-usable credit (see type doc). */
     cloudApiCredits: OrchestrationCloudApiCredits;
+    /** Generic openai-compatible worker endpoint presence (optional for snapshots from older runtimes). */
+    workerEndpoint?: OrchestrationWorkerEndpoint;
     hermes: HermesCliAdapterStatus;
     hermesOpenAiCodex: HermesOpenAiCodexBindingStatus;
     codexAdapterPath: CodexOrchestrationPath;

package/dist/provider-evidence/index.d.ts

@@ -5,4 +5,3 @@ export * from "./collect.js";
 export * from "./wanted-store.js";
 export * from "./shared-cache.js";
 export * from "./recipes-github.js";
-export * from "./recipes-vercel.js";

package/dist/providers/model-preflight.d.ts

@@ -30,4 +30,12 @@ export declare function preflightClaudeModel(model: string | undefined, defaultM
  */
 /** Preflight for `codex` provider — accepts OpenAI/Codex model ids; rejects Claude-family ids. */
 export declare function preflightCodexModel(model: string | undefined, defaultModel: string): ModelPreflightResult;
+/**
+ * Preflight for the generic `openai-compatible` provider. The endpoint behind
+ * `KYNVER_WORKER_BASE_URL` is the only judge of model validity — llama, qwen,
+ * mistral, deepseek, gpt-* and anything else all pass. The ONLY structural
+ * failure is having no model at all (no request and no provider default): a
+ * chat-completions call cannot be issued without one.
+ */
+export declare function preflightOpenAiCompatibleModel(model: string | undefined, defaultModel: string | undefined): ModelPreflightResult;
 export declare function preflightCursorModel(model: string | undefined, defaultModel: string): ModelPreflightResult;

package/dist/providers/openai-compatible-response.d.ts

@@ -0,0 +1,23 @@
+export interface OpenAiCompatibleUsage {
+    inputTokens?: number;
+    outputTokens?: number;
+}
+export interface OpenAiCompatibleCompletion {
+    ok: true;
+    /** Assistant message text (choices[0].message.content, string-joined). */
+    content: string;
+    /** Model id the endpoint reports serving (may differ from the requested id). */
+    model?: string;
+    /** usage.prompt_tokens / usage.completion_tokens when the endpoint reports them. */
+    usage?: OpenAiCompatibleUsage;
+}
+export interface OpenAiCompatibleCompletionError {
+    ok: false;
+    error: string;
+}
+/**
+ * Extract the assistant output + usage from a chat-completions response body.
+ * Tolerant of the shape variance across Ollama/vLLM/OpenRouter/Together/OpenAI —
+ * the caller only needs `content` (the work product) and optional usage/model.
+ */
+export declare function extractOpenAiCompatibleCompletion(body: unknown): OpenAiCompatibleCompletion | OpenAiCompatibleCompletionError;

package/dist/providers/openai-compatible-runner.d.ts

@@ -0,0 +1 @@
+export declare function runOpenAiCompatibleWorkUnit(): Promise<void>;

package/dist/providers/openai-compatible.d.ts

@@ -0,0 +1,46 @@
+import type { WorkerProvider, WorkerProviderStartOptions } from "./types.js";
+export declare const OPENAI_COMPATIBLE_PROVIDER = "openai-compatible";
+export declare function resolveOpenAiCompatibleDefaultModel(env?: NodeJS.ProcessEnv): string | undefined;
+export interface OpenAiCompatibleEndpoint {
+    /** Normalized base URL without a trailing slash, e.g. http://localhost:11434/v1 */
+    baseUrl: string;
+    /** Raw API key when configured; never placed in a child env. */
+    apiKey?: string;
+    timeoutMs: number;
+}
+export declare class OpenAiCompatibleConfigError extends Error {
+}
+/**
+ * Resolve the endpoint from the DAEMON host env. Throws a remediation-quality
+ * error when `KYNVER_WORKER_BASE_URL` is unset or not an http(s) URL.
+ */
+export declare function resolveOpenAiCompatibleEndpoint(env?: NodeJS.ProcessEnv): OpenAiCompatibleEndpoint;
+export declare const OPENAI_COMPATIBLE_SYSTEM_PROMPT: string;
+export interface OpenAiCompatibleChatRequest {
+    url: string;
+    /** Fully constructed headers — the Authorization bearer is baked in here. */
+    headers: Record<string, string>;
+    body: {
+        model: string;
+        temperature: number;
+        stream: false;
+        messages: Array<{
+            role: "system" | "user";
+            content: string;
+        }>;
+    };
+}
+/** Build the single chat-completions request for a work unit. Pure — testable. */
+export declare function buildOpenAiCompatibleChatRequest(endpoint: Pick<OpenAiCompatibleEndpoint, "baseUrl" | "apiKey">, model: string, prompt: string): OpenAiCompatibleChatRequest;
+/** Config the runner child receives over STDIN (never argv/env/disk — carries the key). */
+export interface OpenAiCompatibleRunnerConfig {
+    provider: typeof OPENAI_COMPATIBLE_PROVIDER;
+    model: string;
+    request: OpenAiCompatibleChatRequest;
+    timeoutMs: number;
+    heartbeatPath: string;
+    /** Redacted origin for log/error messages (no path, no credentials). */
+    endpointOrigin: string;
+}
+export declare function buildOpenAiCompatibleRunnerConfig(opts: Pick<WorkerProviderStartOptions, "prompt" | "heartbeatPath">, endpoint: OpenAiCompatibleEndpoint, model: string): OpenAiCompatibleRunnerConfig;
+export declare const openAiCompatibleProvider: WorkerProvider;

package/dist/scheduler-cutover.d.ts

@@ -18,7 +18,7 @@ export interface SchedulerCutoverReport {
     deploymentSteps: string[];
     runnerSteps: string[];
 }
-export declare const DEPLOYMENT_SCHEDULER_CUTOVER_STEPS: readonly ["Vercel/hosted: set KYNVER_SCHEDULER_PROVIDER=qstash", "Vercel/hosted: ensure QSTASH_TOKEN (and QStash signing keys) are configured", "Vercel/hosted: unset OPENCLAW_CRON_STORE_PATH if present"];
+export declare const DEPLOYMENT_SCHEDULER_CUTOVER_STEPS: readonly ["Railway/hosted: set KYNVER_SCHEDULER_PROVIDER=qstash", "Railway/hosted: ensure QSTASH_TOKEN (and QStash signing keys) are configured", "Railway/hosted: unset OPENCLAW_CRON_STORE_PATH if present"];
 export declare const RUNNER_SCHEDULER_CUTOVER_STEPS: readonly ["User runner: unset KYNVER_SCHEDULER_PROVIDER (scheduling is deployment-owned)", "User runner: unset OPENCLAW_CRON_STORE_PATH, OPENCLAW_CRON_SECRET, OPENCLAW_CRON_FIRE_BASE_URL", "User runner: after deployment cutover, run `kynver scheduler attest-cutover` (or set deploymentSchedulerProvider to \"qstash\" in ~/.kynver/config.json)", "Verify: kynver doctor runtime-takeover — hotspot_openclaw_scheduler should pass"];
 export declare function readSchedulerCutoverEnv(env?: NodeJS.ProcessEnv): SchedulerCutoverEnvSnapshot;
 export declare function assessSchedulerCutover(config: Pick<KynverUserConfig, "deploymentSchedulerProvider">, env?: SchedulerCutoverEnvSnapshot): SchedulerCutoverReport;

package/dist/server/adapter-contract.d.ts

@@ -0,0 +1 @@
+export { getAdapterContextContract, listAdapterContextContracts, type AdapterContextCapability, type AdapterContextContract, type AdapterContextContractId, } from "../orchestration-providers/adapter-contract.js";

package/dist/server/adapter-contract.js

@@ -0,0 +1 @@
+var o={"kynver-harness":{adapterId:"kynver-harness",displayName:"Kynver Harness (native)",capabilities:["instruction_policy","persona_context","memory_quality_capture","context_envelope_goal","context_envelope_plan","context_envelope_task","context_envelope_memories","context_envelope_persona"],requiredCapabilities:[],compatibilityNotes:"Context injected via SYSTEM prompt block (buildPrompt). instruction_policy and persona_context are rendered as markdown sections before the task block. context_envelope_* fields (goal/plan/task/memories/persona) are available for dispatch-time injection into the task description \u2014 parity with hermes for shared envelope fields. memory_quality_capture feeds the MARM P7 runtime prompt block."},hermes:{adapterId:"hermes",displayName:"Hermes Forge CLI",capabilities:["context_envelope_goal","context_envelope_plan","context_envelope_task","context_envelope_memories","context_envelope_persona"],requiredCapabilities:[],compatibilityNotes:"External CLI adapter. Context delivered via --context flag or stdin JSON envelope. Does not receive instruction_policy or persona_context / memory_quality_capture (MARM-internal). kynver-harness is the Kynver-native equivalent and covers all hermes capabilities plus richer local context."},cursor:{adapterId:"cursor",displayName:"Cursor / Composer",capabilities:["instruction_policy","persona_context","context_envelope_goal","context_envelope_plan","context_envelope_task","context_envelope_memories"],requiredCapabilities:[],compatibilityNotes:"Context injected via SYSTEM prompt block. Cursor does not receive context_envelope_sessions (no standard block for session history). context_envelope_persona is not forwarded (persona block is absorbed into persona_context markdown)."},codex:{adapterId:"codex",displayName:"Codex (BYO OAuth / Hermes openai-codex)",capabilities:["instruction_policy","context_envelope_goal","context_envelope_plan","context_envelope_task","context_envelope_memories"],requiredCapabilities:[],compatibilityNotes:"Context injected via --instructions flag or system prompt. persona_context not forwarded (Codex has no persona-aware memory lane). memory_quality_capture not surfaced (no MARM completion verification hook on Codex path). context_envelope_sessions and context_envelope_persona omitted."},claude:{adapterId:"claude",displayName:"Claude Code CLI",capabilities:["instruction_policy","persona_context","memory_quality_capture","context_envelope_goal","context_envelope_plan","context_envelope_task","context_envelope_memories","context_envelope_sessions","context_envelope_persona"],requiredCapabilities:[],compatibilityNotes:"Full context injection via SYSTEM prompt block. Supports all capabilities including session summaries and the full persona block. Equivalent to kynver-harness in capability coverage."}};function n(e){let t=o[e];return t||{adapterId:e,displayName:`Unknown adapter (${e})`,capabilities:[],requiredCapabilities:[],compatibilityNotes:"Unknown adapter \u2014 no context-envelope routing performed."}}function a(){return Object.values(o)}export{n as getAdapterContextContract,a as listAdapterContextContracts};