@promptbook/cli 0.112.0 → 0.113.0-1

package/apps/agents-server/src/utils/vpsSelfUpdate.ts

@@ -203,6 +203,10 @@ export type VpsSelfUpdateOverview = {
      * Author timestamp of the latest remote commit in ISO format.
      */
     readonly latestRemoteCommitDate: string | null;
+    /**
+     * Latest remote commit subject.
+     */
+    readonly latestRemoteCommitMessage: string | null;
     /**
      * Number of commits the deployed checkout is behind the latest remote commit, or `null` when unknown.
      */
@@ -456,22 +460,24 @@ export async function readVpsSelfUpdateOverview(): Promise<VpsSelfUpdateOverview
         });
     }
 
-    const [currentCommitSha, currentCommitMessage, currentCommitDate, latestRemoteCommitSha] = await Promise.all([
-        runGitInRepository(repositoryDirectory, ['rev-parse', 'HEAD']),
-        runGitInRepository(repositoryDirectory, ['log', '-1', '--format=%s']),
-        runGitInRepository(repositoryDirectory, ['log', '-1', '--format=%aI']),
-        readRemoteCommitSha(repositoryDirectory, currentEnvironment.branch, originRepositoryUrl),
+    await refreshVpsSelfUpdateRemoteBranch(repositoryDirectory, currentEnvironment.branch, originRepositoryUrl);
+
+    const [currentCommit, latestRemoteCommitSha] = await Promise.all([
+        readCommitMetadataFromRepository(repositoryDirectory, 'HEAD'),
+        readLatestRemoteBranchCommitSha(repositoryDirectory, currentEnvironment.branch, originRepositoryUrl),
     ]);
-    const latestRemoteCommitDate = latestRemoteCommitSha
-        ? await readCommitDateFromRepository(repositoryDirectory, latestRemoteCommitSha)
+    const latestRemoteCommit = latestRemoteCommitSha
+        ? await readCommitMetadataFromRepository(repositoryDirectory, latestRemoteCommitSha)
         : null;
+    const currentCommitSha = currentCommit?.commitSha ?? null;
+    const latestRemoteCommitResolvedSha = latestRemoteCommit?.commitSha ?? latestRemoteCommitSha;
     const commitsBehindCount =
-        currentCommitSha && latestRemoteCommitSha
-            ? await countCommitsBetween(repositoryDirectory, currentCommitSha, latestRemoteCommitSha)
+        currentCommitSha && latestRemoteCommitResolvedSha
+            ? await countCommitsBetween(repositoryDirectory, currentCommitSha, latestRemoteCommitResolvedSha)
             : null;
     const pendingCommits =
-        currentCommitSha && latestRemoteCommitSha
-            ? await listCommitsBetween(repositoryDirectory, currentCommitSha, latestRemoteCommitSha)
+        currentCommitSha && latestRemoteCommitResolvedSha
+            ? await listCommitsBetween(repositoryDirectory, currentCommitSha, latestRemoteCommitResolvedSha)
             : [];
     const resolvedJob = resolveVpsSelfUpdateJobForOverview(job, {
         currentEnvironment,
@@ -486,15 +492,16 @@ export async function readVpsSelfUpdateOverview(): Promise<VpsSelfUpdateOverview
         repositoryDirectory,
         currentCommitSha,
         currentCommitShortSha: abbreviateCommitSha(currentCommitSha),
-        currentCommitMessage,
-        currentCommitDate,
-        latestRemoteCommitSha,
-        latestRemoteCommitShortSha: abbreviateCommitSha(latestRemoteCommitSha),
-        latestRemoteCommitDate,
+        currentCommitMessage: currentCommit?.subject ?? null,
+        currentCommitDate: currentCommit?.authoredAt ?? null,
+        latestRemoteCommitSha: latestRemoteCommitResolvedSha,
+        latestRemoteCommitShortSha: abbreviateCommitSha(latestRemoteCommitResolvedSha),
+        latestRemoteCommitDate: latestRemoteCommit?.authoredAt ?? null,
+        latestRemoteCommitMessage: latestRemoteCommit?.subject ?? null,
         commitsBehindCount,
         pendingCommits,
         isUpdateAvailable: Boolean(
-            currentCommitSha && latestRemoteCommitSha && currentCommitSha !== latestRemoteCommitSha,
+            currentCommitSha && latestRemoteCommitResolvedSha && currentCommitSha !== latestRemoteCommitResolvedSha,
         ),
         originRepositoryUrl,
         isOriginRepositoryDefault: originRepositoryUrl === VPS_SELF_UPDATE_DEFAULT_ORIGIN_REPOSITORY_URL,
@@ -525,11 +532,34 @@ export type VpsSelfUpdatePendingCommit = {
     readonly authoredAt: string | null;
 };
 
+/**
+ * Browser-safe metadata read from one git commit object.
+ */
+type VpsSelfUpdateCommitMetadata = {
+    /**
+     * Full commit hash.
+     */
+    readonly commitSha: string;
+    /**
+     * Single-line commit subject.
+     */
+    readonly subject: string;
+    /**
+     * Author timestamp in ISO format or `null` when unknown.
+     */
+    readonly authoredAt: string | null;
+};
+
 /**
  * Hard ceiling for the pending-commits listing returned in the overview to avoid huge payloads on a long-stale server.
  */
 const VPS_SELF_UPDATE_MAX_PENDING_COMMITS = 100;
 
+/**
+ * Number of latest branch commits fetched for the update overview.
+ */
+const VPS_SELF_UPDATE_OVERVIEW_FETCH_DEPTH = VPS_SELF_UPDATE_MAX_PENDING_COMMITS + 1;
+
 /**
  * Browser-safe summary of one commit that the super admin can pick from the custom-target picker.
  */
@@ -825,6 +855,7 @@ function createUnavailableOverview(context: {
         latestRemoteCommitSha: null,
         latestRemoteCommitShortSha: null,
         latestRemoteCommitDate: null,
+        latestRemoteCommitMessage: null,
         commitsBehindCount: null,
         pendingCommits: [],
         isUpdateAvailable: false,
@@ -1011,6 +1042,18 @@ function resolveVpsSelfUpdateStateDirectory(): string {
     return resolve(dirname(resolveVpsEnvironmentFilePath()), '.promptbook', 'self-update');
 }
 
+/**
+ * Reads a lightweight snapshot of the currently persisted standalone VPS self-update job.
+ *
+ * Reads only the persisted status file and its log tail — no git access, no remote fetching —
+ * so it is safe to call from frequent polling loops such as the admin task manager.
+ *
+ * @returns Parsed job snapshot (status `idle` when no job has ever been persisted).
+ */
+export async function readVpsSelfUpdateJobSnapshot(): Promise<VpsSelfUpdateJobSnapshot> {
+    return readPersistedVpsSelfUpdateJob();
+}
+
 /**
  * Reads one persisted update-job snapshot from disk.
  *
@@ -1171,6 +1214,59 @@ async function runGitInRepository(repositoryDirectory: string, args: ReadonlyArr
     }
 }
 
+/**
+ * Fetches the tracked remote branch into the local object database before building the browser overview.
+ *
+ * @param repositoryDirectory - Repository checkout path.
+ * @param branch - Target branch.
+ * @param originRepositoryUrl - Configured upstream repository URL.
+ */
+async function refreshVpsSelfUpdateRemoteBranch(
+    repositoryDirectory: string,
+    branch: string,
+    originRepositoryUrl: string,
+): Promise<void> {
+    if (!branch) {
+        return;
+    }
+
+    await runGitInRepository(repositoryDirectory, [
+        'fetch',
+        '--no-tags',
+        '--prune',
+        `--depth=${VPS_SELF_UPDATE_OVERVIEW_FETCH_DEPTH}`,
+        originRepositoryUrl,
+        `+refs/heads/${branch}:${createVpsSelfUpdateRemoteBranchReference(branch)}`,
+    ]);
+}
+
+/**
+ * Reads the latest tracked-branch commit from the local remote-tracking ref, falling back to `ls-remote`.
+ *
+ * @param repositoryDirectory - Repository checkout path.
+ * @param branch - Target branch.
+ * @param originRepositoryUrl - Configured upstream repository URL.
+ * @returns Remote branch commit sha or `null`.
+ */
+async function readLatestRemoteBranchCommitSha(
+    repositoryDirectory: string,
+    branch: string,
+    originRepositoryUrl: string,
+): Promise<string | null> {
+    if (!branch) {
+        return null;
+    }
+
+    const remoteBranchReference = createVpsSelfUpdateRemoteBranchReference(branch);
+    const localCommitSha = await runGitInRepository(repositoryDirectory, [
+        'rev-parse',
+        '--verify',
+        `${remoteBranchReference}^{commit}`,
+    ]);
+
+    return localCommitSha || readRemoteCommitSha(repositoryDirectory, branch, originRepositoryUrl);
+}
+
 /**
  * Reads the latest remote branch commit without mutating the local checkout.
  *
@@ -1197,17 +1293,47 @@ async function readRemoteCommitSha(
 }
 
 /**
- * Reads the author timestamp of a known commit from the local repository.
+ * Creates the local remote-tracking reference used for the update overview fetch.
+ *
+ * @param branch - Target branch.
+ * @returns Local remote-tracking reference.
+ */
+function createVpsSelfUpdateRemoteBranchReference(branch: string): string {
+    return `refs/remotes/origin/${branch}`;
+}
+
+/**
+ * Reads hash, subject and author timestamp for one known commit from the local repository.
  *
  * @param repositoryDirectory - Repository checkout path.
- * @param commitSha - Commit hash to look up.
- * @returns ISO timestamp or `null` when the commit is unknown locally.
+ * @param commitReference - Commit hash or git revision reference to look up.
+ * @returns Commit metadata or `null` when the commit cannot be resolved locally.
  */
-async function readCommitDateFromRepository(
+async function readCommitMetadataFromRepository(
     repositoryDirectory: string,
-    commitSha: string,
-): Promise<string | null> {
-    return runGitInRepository(repositoryDirectory, ['log', '-1', '--format=%aI', commitSha]);
+    commitReference: string,
+): Promise<VpsSelfUpdateCommitMetadata | null> {
+    const output = await runGitInRepository(repositoryDirectory, [
+        'log',
+        '-1',
+        `--format=%H${GIT_LOG_FIELD_SEPARATOR}%aI${GIT_LOG_FIELD_SEPARATOR}%s`,
+        commitReference,
+    ]);
+    if (!output) {
+        return null;
+    }
+
+    const fields = output.split(GIT_LOG_FIELD_SEPARATOR);
+    const commitSha = fields[0] ?? '';
+    if (!commitSha) {
+        return null;
+    }
+
+    return {
+        commitSha,
+        authoredAt: fields[1] || null,
+        subject: fields.slice(2).join(GIT_LOG_FIELD_SEPARATOR),
+    };
 }
 
 /**

package/esm/apps/agents-server/src/constants/serverLimits.d.ts

@@ -28,6 +28,12 @@ export declare const DEFAULT_SPAWN_AGENT_RATE_LIMIT_WINDOW_MS: number;
  * @private shared Agents Server constant
  */
 export declare const DEFAULT_LOCAL_AGENT_RUNNER_MAX_FAILED_ATTEMPTS = 3;
+/**
+ * Default maximum number of local runner harness instances allowed to answer queued messages at once.
+ *
+ * @private shared Agents Server constant
+ */
+export declare const DEFAULT_LOCAL_AGENT_RUNNER_MAX_PARALLEL_MESSAGES = 3;
 /**
  * Stable keys used by the dedicated server-limits table.
  *
@@ -42,6 +48,7 @@ export declare const SERVER_LIMIT_KEYS: {
     readonly SPAWN_AGENT_RATE_LIMIT_MAX: "SPAWN_AGENT_RATE_LIMIT_MAX";
     readonly SPAWN_AGENT_RATE_LIMIT_WINDOW_MS: "SPAWN_AGENT_RATE_LIMIT_WINDOW_MS";
     readonly LOCAL_AGENT_RUNNER_MAX_FAILED_ATTEMPTS: "LOCAL_AGENT_RUNNER_MAX_FAILED_ATTEMPTS";
+    readonly LOCAL_AGENT_RUNNER_MAX_PARALLEL_MESSAGES: "LOCAL_AGENT_RUNNER_MAX_PARALLEL_MESSAGES";
 };
 /**
  * One supported dedicated server-limit key.
@@ -156,6 +163,16 @@ export declare const SERVER_LIMIT_DEFINITIONS: ({
     minimumValue: number;
     step: number;
     legacyMetadataKeys: never[];
+} | {
+    key: "LOCAL_AGENT_RUNNER_MAX_PARALLEL_MESSAGES";
+    category: "Local agent runner";
+    title: string;
+    description: string;
+    unit: "count";
+    defaultValue: number;
+    minimumValue: number;
+    step: number;
+    legacyMetadataKeys: never[];
 })[];
 /**
  * Fast lookup map used by server-limit validators and UI helpers.