@kynver-app/runtime 0.1.93 → 0.1.99

package/dist/installed-package-versions.d.ts

@@ -3,4 +3,6 @@ export type InstalledPackageVersionMap = Record<string, {
     observedAt: string;
     path: string;
 }>;
+/** Candidate install paths for one managed package across OpenClaw + global npm roots. */
+export declare function installedPackageJsonCandidates(packageName: string): string[];
 export declare function collectInstalledPackageVersions(observedAt?: string): Promise<InstalledPackageVersionMap>;

package/dist/resource-gate.d.ts

@@ -1,6 +1,7 @@
 import { type KynverUserConfig } from "./config.js";
 import type { WorkerCapSource } from "./worker-cap-source.js";
 import type { DispatchNextDiskGateShape } from "./callbacks.js";
+import type { HarnessWorkerRecord } from "./status.js";
 /** Default RAM budget per worker (~500 MiB, dogfood measured). Internal — not a setup knob. */
 export declare const DEFAULT_PER_WORKER_MEM_BYTES: number;
 /** Keep headroom for OS / IDE. Internal — not a setup knob. */
@@ -47,6 +48,12 @@ export declare function computeAutoMaxWorkers(totalMemBytes: number, opts?: {
     memReserveBytes?: number;
     memUtilization?: number;
 }): number;
+/**
+ * PID existence is not enough on long-running hosts: Linux can reuse an old
+ * worker PID for an unrelated process, which makes stale worker.json records
+ * look alive and can falsely saturate the global worker gate.
+ */
+export declare function workerProcessMatchesRecord(worker: HarnessWorkerRecord): boolean;
 /** Count active workers in ONE run (kept for callers/tests scoped to a run). */
 export declare function countActiveWorkers(runId: string): number;
 /**

package/dist/vercel/index.d.ts

@@ -1,3 +1,4 @@
+export { fetchVercelDeploymentStatus, mapVercelReadyStateToEvidenceStatus, type VercelDeploymentLookupOptions, type VercelDeploymentLookupResult, } from "./vercel-api.js";
 export { classifyVercelUrl, isDashboardVercelUrl, isInspectableVercelTarget, type ClassifiedVercelUrl, type VercelUrlKind, } from "./vercel-url.js";
 export { isVercelStatusContext, normalizeGitHubStatusState, pickVercelStatusContext, type GitHubCommitStatusRow, type GitHubStatusState, type GitHubVercelStatusContext, } from "./vercel-github-status.js";
-export { collectVercelEvidence, evidenceFromGitHubVercelStatus, resolveVercelInspectTarget, type CollectVercelEvidenceInput, type RunVercelInspect, type VercelEvidenceResult, type VercelEvidenceStatus, type VercelInspectCommandResult, } from "./vercel-evidence.js";
+export { collectVercelEvidence, evidenceFromGitHubVercelStatus, resolveVercelInspectTarget, type CollectVercelEvidenceInput, type RunVercelDeploymentLookup, type RunVercelInspect, type VercelEvidenceResult, type VercelEvidenceStatus, type VercelInspectCommandResult, } from "./vercel-evidence.js";

package/dist/vercel/vercel-api.d.ts

@@ -0,0 +1,17 @@
+export interface VercelDeploymentLookupResult {
+    ok: boolean;
+    readyState: string | null;
+    previewUrl: string | null;
+    error: string | null;
+}
+export interface VercelDeploymentLookupOptions {
+    token?: string | null;
+    teamId?: string | null;
+    fetchImpl?: typeof fetch;
+}
+/**
+ * Fetch deployment state by id (`dpl_*`) or `*.vercel.app` host URL.
+ * Requires `VERCEL_TOKEN` (or explicit token) — never shells out to the Vercel CLI.
+ */
+export declare function fetchVercelDeploymentStatus(deploymentIdOrUrl: string, options?: VercelDeploymentLookupOptions): Promise<VercelDeploymentLookupResult>;
+export declare function mapVercelReadyStateToEvidenceStatus(readyState: string | null, githubPending: boolean): "ready" | "building" | "error";

package/dist/vercel/vercel-evidence.d.ts

@@ -1,3 +1,4 @@
+import { type VercelDeploymentLookupResult } from "./vercel-api.js";
 import { type GitHubCommitStatusRow, type GitHubStatusState, type GitHubVercelStatusContext } from "./vercel-github-status.js";
 import { type ClassifiedVercelUrl } from "./vercel-url.js";
 export type VercelEvidenceStatus = "ready" | "building" | "error" | "unavailable" | "not_run";
@@ -7,22 +8,19 @@ export interface VercelEvidenceResult {
     deploymentUrl: string | null;
     summary: string | null;
     observedAt: string | null;
-    /** True when `vercel inspect` was not run (dashboard URL or trusted GitHub state). */
+    /** True when Vercel API lookup was not run (GitHub-only or missing token). */
     inspectSkipped: boolean;
     inspectReason: string | null;
     githubState: GitHubStatusState | null;
     vercelContext: string | null;
 }
-export interface VercelInspectCommandResult {
-    ok: boolean;
-    exitCode: number | null;
-    stdout: string;
-    stderr: string;
-    error: string | null;
-}
-export type RunVercelInspect = (target: string, waitSeconds: number) => VercelInspectCommandResult;
+/** @deprecated Renamed — use VercelDeploymentLookupResult from vercel-api. */
+export type VercelInspectCommandResult = VercelDeploymentLookupResult;
+export type RunVercelDeploymentLookup = (target: string) => Promise<VercelDeploymentLookupResult>;
+/** @deprecated Renamed — use RunVercelDeploymentLookup. */
+export type RunVercelInspect = RunVercelDeploymentLookup;
 /**
- * Resolve the CLI inspect target. Never returns a vercel.com dashboard page URL.
+ * Resolve the deployment lookup target. Never returns a vercel.com dashboard page URL.
  */
 export declare function resolveVercelInspectTarget(rawUrl: string | null | undefined): {
     target: string | null;
@@ -34,15 +32,17 @@ export declare function evidenceFromGitHubVercelStatus(statuses: GitHubCommitSta
 }): VercelEvidenceResult;
 export interface CollectVercelEvidenceInput {
     statuses?: GitHubCommitStatusRow[] | null;
-    /** When false, never shell out to the Vercel CLI (GitHub status only). */
+    /** When false, never call Vercel REST API (GitHub status only). Default path. */
     allowInspect?: boolean;
+    /** @deprecated waitSeconds was for CLI inspect; ignored for API lookup. */
     waitSeconds?: number;
-    runInspect?: RunVercelInspect;
+    runInspect?: RunVercelDeploymentLookup;
     observedAt?: string;
 }
 /**
- * Prefer GitHub Vercel StatusContext.state for gates. Run `vercel inspect` only when
- * inspectable (deployment host or id) and GitHub state is not already terminal success.
+ * Prefer GitHub Vercel StatusContext.state for gates. Call Vercel REST API only when
+ * inspectable (deployment host or id), GitHub state is not terminal success, and
+ * `allowInspect` is true with VERCEL_TOKEN configured.
  */
-export declare function collectVercelEvidence(input: CollectVercelEvidenceInput): VercelEvidenceResult;
+export declare function collectVercelEvidence(input: CollectVercelEvidenceInput): Promise<VercelEvidenceResult>;
 export type { GitHubVercelStatusContext };

package/dist/vercel/vercel-url.d.ts

@@ -3,16 +3,16 @@ export interface ClassifiedVercelUrl {
     kind: VercelUrlKind;
     /** Original URL when it is a usable preview/deployment host. */
     previewUrl: string | null;
-    /** Argument suitable for `vercel inspect` (id or host URL), never a dashboard page URL. */
+    /** Deployment id or host URL suitable for Vercel REST API lookup — never a dashboard page URL. */
     inspectTarget: string | null;
     /** Deployment id extracted from dashboard paths when present. */
     deploymentId: string | null;
 }
-/** True when the string is safe to pass to `vercel inspect` (never a dashboard page URL). */
+/** True when the string is safe for Vercel REST API deployment lookup (never a dashboard page URL). */
 export declare function isInspectableVercelTarget(target: string): boolean;
 /**
  * Classify a Vercel-related URL from GitHub commit status target_url.
- * `vercel inspect` accepts deployment ids and `*.vercel.app` hosts — not vercel.com dashboard links.
+ * Vercel REST API accepts deployment ids and `*.vercel.app` hosts — not vercel.com dashboard links.
  */
 export declare function classifyVercelUrl(raw: string): ClassifiedVercelUrl;
 export declare function isDashboardVercelUrl(raw: string): boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kynver-app/runtime",
-  "version": "0.1.93",
+  "version": "0.1.99",
   "description": "Kynver AgentOS local execution runtime and CLI",
   "type": "module",
   "main": "./dist/index.js",