@promptbook/cli 0.114.0-5 → 0.114.0-7

package/esm/scripts/run-agent-messages/messages/buildAgentMessagePrompt.d.ts

@@ -1,8 +1,14 @@
 import { type AgentProjectsPromptSectionOptions } from './buildAgentProjectsPromptSection';
+import { type AgentTeamPromptWorkspace } from './buildAgentTeamPromptSection';
 /**
  * Options adjusting the generated agent message prompt.
  */
-export type BuildAgentMessagePromptOptions = AgentProjectsPromptSectionOptions;
+export type BuildAgentMessagePromptOptions = AgentProjectsPromptSectionOptions & {
+    /**
+     * Optional local TEAM roster prepared by the Agents Server for this user turn.
+     */
+    teamWorkspace?: AgentTeamPromptWorkspace;
+};
 /**
  * Builds the prompt sent to the selected coding runner for one queued user-thread book.
  */

package/esm/scripts/run-agent-messages/messages/buildAgentTeamPromptSection.d.ts

@@ -0,0 +1,12 @@
+import { type AgentTeamConversationWorkspaceManifest } from '../../../src/book-3.0/AgentTeamConversationWorkspace';
+/**
+ * TEAM workspace information made visible to one coding-harness prompt.
+ */
+export type AgentTeamPromptWorkspace = {
+    readonly relativeWorkspacePath: string;
+    readonly manifest: AgentTeamConversationWorkspaceManifest;
+};
+/**
+ * Builds the optional single-run TEAM consultation instructions for a coding harness.
+ */
+export declare function buildAgentTeamPromptSection(workspace: AgentTeamPromptWorkspace | undefined): string;

package/esm/scripts/run-agent-messages/messages/finalizeAgentTeamConversationWorkspace.d.ts

@@ -0,0 +1,16 @@
+import type { AgentMessageFile } from './AgentMessageFile';
+import type { AgentTeamPromptWorkspace } from './buildAgentTeamPromptSection';
+/**
+ * TEAM transcript files retained next to the finished user message.
+ */
+export type FinishedAgentTeamConversationWorkspace = {
+    readonly relativePaths: ReadonlyArray<string>;
+};
+/**
+ * Moves harness-created TEAM conversation transcripts into the finished-message history.
+ */
+export declare function finalizeAgentTeamConversationWorkspace(options: {
+    readonly projectPath: string;
+    readonly queuedMessage: AgentMessageFile;
+    readonly workspace: AgentTeamPromptWorkspace | null;
+}): Promise<FinishedAgentTeamConversationWorkspace | null>;

package/esm/scripts/run-agent-messages/messages/loadAgentTeamConversationWorkspace.d.ts

@@ -0,0 +1,6 @@
+import type { AgentMessageFile } from './AgentMessageFile';
+import type { AgentTeamPromptWorkspace } from './buildAgentTeamPromptSection';
+/**
+ * Loads the optional TEAM roster snapshot for one queued message.
+ */
+export declare function loadAgentTeamConversationWorkspace(projectPath: string, queuedMessage: AgentMessageFile): Promise<AgentTeamPromptWorkspace | null>;

package/esm/scripts/run-codex-prompts/common/normalizeLineEndingsInChangedFiles.d.ts

@@ -1,9 +1,8 @@
+import type { WorkingTreeChangesSnapshot } from '../git/workingTreeChanges';
 /**
  * Snapshot of file hashes for files that were already dirty before a coding round started.
  */
-export type ChangedFilesSnapshot = {
-    readonly changedFileHashes: ReadonlyMap<string, string>;
-};
+export type ChangedFilesSnapshot = WorkingTreeChangesSnapshot;
 /**
  * Options for normalizing line endings in files changed during one coding round.
  */

package/esm/scripts/run-codex-prompts/git/coderCommitScope.d.ts

@@ -0,0 +1,31 @@
+import type { WorkingTreeChangesSnapshot } from './workingTreeChanges';
+/**
+ * Working tree state captured right before one `ptbk coder` operation starts changing the project.
+ *
+ * Note: This is the single mechanism which every `ptbk coder` command uses to commit only the files relevant
+ *       for the operation it has just performed, instead of everything which happens to be changed in the project.
+ */
+export type CoderCommitScope = {
+    /**
+     * Project the operation runs in.
+     */
+    readonly projectPath: string;
+    /**
+     * Files which were already changed before the operation started.
+     */
+    readonly snapshotBeforeOperation: WorkingTreeChangesSnapshot;
+};
+/**
+ * Captures the working tree state before one `ptbk coder` operation changes anything.
+ *
+ * The captured scope is passed to the commit of the very same operation, which then commits exactly the files
+ * this operation has created, changed, moved or deleted.
+ */
+export declare function captureCoderCommitScope(projectPath: string): Promise<CoderCommitScope>;
+/**
+ * Resolves the repository-relative paths which one `ptbk coder` operation has really changed.
+ *
+ * Files which were already changed before the operation started and which the operation did not touch are
+ * never part of the result, so they stay in the working tree instead of being swept into the commit.
+ */
+export declare function resolveCoderCommitScopePaths(scope: CoderCommitScope): Promise<ReadonlyArray<string>>;

package/esm/scripts/run-codex-prompts/git/coderGitSync.d.ts

@@ -1,3 +1,4 @@
+import type { CoderCommitScope } from './coderCommitScope';
 /**
  * Automatic git synchronization of the project changes made by one `ptbk coder` command.
  *
@@ -24,6 +25,17 @@ export type CoderGitSyncOptions = {
  * Note: This is the default for every command and helper which supports the git synchronization.
  */
 export declare const DISABLED_CODER_GIT_SYNC_OPTIONS: CoderGitSyncOptions;
+/**
+ * Pulls the latest repository changes and captures the working tree state before a `ptbk coder` command
+ * changes the project.
+ *
+ * The returned scope is handed over to `$commitCoderChanges` of the very same command, which then commits
+ * exactly the files this command has changed.
+ */
+export declare function $startCoderGitSync(options: {
+    readonly gitSync: CoderGitSyncOptions;
+    readonly projectPath?: string;
+}): Promise<CoderCommitScope>;
 /**
  * Pulls the latest repository changes before a `ptbk coder` command changes the project.
  */
@@ -34,10 +46,11 @@ export declare function $pullCoderChanges(options: {
 /**
  * Commits - and when requested also pushes - the changes one `ptbk coder` command has just made.
  *
- * Note: A repository without any change is left alone instead of creating an empty commit.
+ * Note: Only the files this very command has changed are committed, everything else is left in the working tree.
+ * Note: A command which changed nothing is left alone instead of creating an empty commit.
  */
 export declare function $commitCoderChanges(options: {
     readonly gitSync: CoderGitSyncOptions;
     readonly commitMessage: string;
-    readonly projectPath?: string;
+    readonly commitScope: CoderCommitScope;
 }): Promise<void>;

package/esm/scripts/run-codex-prompts/git/commitChanges.d.ts

@@ -1,7 +1,7 @@
 /**
  * Commits staged changes with the provided message using the dedicated coding-agent identity when configured,
  * otherwise falls back to the default Git configuration. Remote pushing is opt-in via `options.autoPush`,
- * `options.includePaths` can restrict staging, `options.onlyPaths` can restrict the commit pathspec,
+ * `options.relevantPaths` restricts both the staging and the commit to the files of the current operation,
  * `options.excludePaths` can keep temporary artifacts out of the created commit and
  * `options.isEmptyCommitAllowed` keeps a round without any file change from failing.
  *
@@ -10,8 +10,14 @@
  */
 export declare function commitChanges(message: string, options?: {
     autoPush?: boolean;
-    includePaths?: ReadonlyArray<string>;
-    onlyPaths?: ReadonlyArray<string>;
+    /**
+     * Repository-relative paths which are relevant for the current operation.
+     *
+     * Only these paths are staged and only they end up in the created commit, so unrelated changes of the
+     * project are left in the working tree. Everything is committed when the paths are not provided at all,
+     * while an empty list commits nothing but the file changes already staged before.
+     */
+    relevantPaths?: ReadonlyArray<string>;
     excludePaths?: ReadonlyArray<string>;
     projectPath?: string;
     isEmptyCommitAllowed?: boolean;

package/esm/scripts/run-codex-prompts/git/workingTreeChanges.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Snapshot of file hashes for files that were already dirty before one operation started.
+ *
+ * Note: This is the single source of truth about which files one `ptbk coder` operation has really changed,
+ *       used both for normalizing line endings and for committing only the relevant files.
+ */
+export type WorkingTreeChangesSnapshot = {
+    /**
+     * Hash of every dirty file at the moment the snapshot was taken.
+     *
+     * A file which was dirty but could not be hashed (a deleted file or a non-regular file) is stored as `null`,
+     * so it can be told apart from a file which was not dirty at all.
+     */
+    readonly changedFileHashes: ReadonlyMap<string, string | null>;
+};
+/**
+ * Captures hashes for files that are dirty before one operation starts.
+ */
+export declare function captureWorkingTreeChangesSnapshot(projectPath: string): Promise<WorkingTreeChangesSnapshot>;
+/**
+ * Lists the repository-relative paths which really changed since the snapshot was taken.
+ *
+ * A file which was already dirty before and was not touched afterwards is not listed, so the result contains
+ * exactly the files changed by the operation which the snapshot wraps.
+ */
+export declare function listFilesChangedSinceSnapshot(projectPath: string, snapshot: WorkingTreeChangesSnapshot): Promise<ReadonlyArray<string>>;
+/**
+ * Lists dirty tracked files and untracked files in the working tree.
+ */
+export declare function listWorkingTreeChangedFiles(projectPath: string): Promise<ReadonlyArray<string>>;
+/**
+ * Reads the content hash of one repository-relative working tree file.
+ *
+ * @returns Hash of a regular file, otherwise `null` for a deleted or non-regular file.
+ */
+export declare function readWorkingTreeFileHash(projectPath: string, relativePath: string): Promise<string | null>;
+/**
+ * Normalizes Git output paths for internal matching.
+ */
+export declare function normalizeGitFilePath(filePath: string): string;

package/esm/scripts/run-codex-prompts/server/coderServerHtml.d.ts

@@ -6,4 +6,4 @@
  *
  * @private internal constant of `ptbk coder server`
  */
-export declare const CODER_SERVER_HTML = "<!DOCTYPE html>\n<html lang=\"en\">\n<head>\n  <meta charset=\"UTF-8\">\n  <meta name=\"viewport\" content=\"width=device-width, initial-scale=1.0\">\n  <title>Ptbk Coder Server</title>\n  <style>\n    * { box-sizing: border-box; margin: 0; padding: 0; }\n    body {\n      font-family: -apple-system, BlinkMacSystemFont, \"Segoe UI\", Roboto, sans-serif;\n      background: #f6f7f9;\n      color: #1f2933;\n      min-height: 100vh;\n    }\n\n    header {\n      background: #22313f;\n      color: white;\n      padding: 12px 18px;\n      display: flex;\n      align-items: center;\n      gap: 12px;\n      position: sticky;\n      top: 0;\n      z-index: 10;\n      box-shadow: 0 2px 10px rgba(15,23,42,0.22);\n    }\n    header h1 { font-size: 17px; font-weight: 700; flex-shrink: 0; letter-spacing: 0; }\n\n    .status-badge {\n      padding: 3px 10px;\n      border-radius: 999px;\n      font-size: 11px;\n      font-weight: 700;\n      text-transform: uppercase;\n      flex-shrink: 0;\n    }\n    .status-RUNNING { background: #0b875b; color: white; }\n    .status-PAUSING { background: #d97904; color: white; }\n    .status-PAUSED { background: #b42318; color: white; }\n\n    #pause-label {\n      font-size: 12px;\n      color: rgba(255,255,255,0.75);\n      flex: 1;\n      min-width: 0;\n      overflow: hidden;\n      text-overflow: ellipsis;\n      white-space: nowrap;\n    }\n\n    .btn {\n      padding: 6px 12px;\n      border: 0;\n      border-radius: 4px;\n      cursor: pointer;\n      font-size: 13px;\n      font-weight: 700;\n      transition: background 0.15s, opacity 0.15s;\n      flex-shrink: 0;\n    }\n    .btn:disabled { opacity: 0.55; cursor: default; }\n    .btn-pause { background: #ffd166; color: #1f2933; }\n    .btn-resume { background: #0b875b; color: white; }\n    .btn-save { background: #2563eb; color: white; }\n    .btn-cancel { background: #edf0f4; color: #1f2933; }\n\n    .run-strip {\n      background: white;\n      border-bottom: 1px solid #d8dee8;\n      padding: 12px 18px;\n      display: grid;\n      grid-template-columns: minmax(220px, 1.2fr) minmax(240px, 1fr) minmax(260px, 1.4fr);\n      gap: 14px;\n      align-items: center;\n    }\n    .run-title {\n      font-size: 14px;\n      font-weight: 700;\n      overflow: hidden;\n      text-overflow: ellipsis;\n      white-space: nowrap;\n    }\n    .run-subtitle,\n    .run-current,\n    .run-output {\n      color: #64748b;\n      font-size: 12px;\n      line-height: 1.45;\n      overflow: hidden;\n    }\n    .run-current,\n    .run-output {\n      display: -webkit-box;\n      -webkit-box-orient: vertical;\n      -webkit-line-clamp: 2;\n    }\n    .progress-shell {\n      display: grid;\n      grid-template-columns: 1fr auto;\n      gap: 8px;\n      align-items: center;\n    }\n    .progress-track {\n      height: 10px;\n      background: #e4e9f0;\n      border-radius: 999px;\n      overflow: hidden;\n    }\n    .progress-fill {\n      display: block;\n      height: 100%;\n      width: 0;\n      background: linear-gradient(90deg, #0b875b, #2563eb);\n      transition: width 0.2s;\n    }\n    .progress-label {\n      color: #475569;\n      font-size: 12px;\n      font-weight: 700;\n      min-width: 72px;\n      text-align: right;\n    }\n\n    .board {\n      display: flex;\n      gap: 14px;\n      padding: 16px;\n      overflow-x: auto;\n      min-height: calc(100vh - 119px);\n      align-items: flex-start;\n    }\n\n    .column {\n      background: #e9edf3;\n      border-top: 4px solid #94a3b8;\n      border-radius: 6px;\n      padding: 10px;\n      min-width: 250px;\n      width: 270px;\n      flex-shrink: 0;\n    }\n    .column-backlog { border-top-color: #64748b; }\n    .column-low-priority { border-top-color: #d97904; }\n    .column-todo { border-top-color: #2563eb; }\n    .column-in-progress { border-top-color: #7c3aed; }\n    .column-done { border-top-color: #0b875b; }\n    .column-errors { border-top-color: #b42318; }\n    .column-finished { border-top-color: #0891b2; }\n\n    .column-header {\n      font-size: 12px;\n      font-weight: 800;\n      text-transform: uppercase;\n      color: #475569;\n      margin-bottom: 10px;\n      display: flex;\n      align-items: center;\n      justify-content: space-between;\n      gap: 8px;\n    }\n    .column-count {\n      background: rgba(255,255,255,0.72);\n      border-radius: 999px;\n      padding: 2px 8px;\n      font-size: 11px;\n      color: #475569;\n    }\n    .column-cards { min-height: 40px; }\n\n    .card {\n      background: white;\n      border-radius: 6px;\n      padding: 10px 12px;\n      margin-bottom: 8px;\n      box-shadow: 0 1px 3px rgba(15,23,42,0.12);\n      cursor: pointer;\n      border-left: 3px solid #94a3b8;\n    }\n    .card:hover { box-shadow: 0 4px 12px rgba(15,23,42,0.16); }\n    .card-backlog { border-left-color: #64748b; }\n    .card-low-priority { border-left-color: #d97904; }\n    .card-todo { border-left-color: #2563eb; }\n    .card-in-progress { border-left-color: #7c3aed; }\n    .card-done { border-left-color: #0b875b; }\n    .card-errors { border-left-color: #b42318; }\n    .card-finished { border-left-color: #0891b2; }\n\n    .card-file {\n      font-size: 10px;\n      color: #7b8794;\n      margin-bottom: 6px;\n      font-weight: 600;\n      overflow: hidden;\n      text-overflow: ellipsis;\n      white-space: nowrap;\n    }\n    .card-summary {\n      font-size: 13px;\n      line-height: 1.45;\n      color: #1f2933;\n      word-break: break-word;\n      white-space: pre-wrap;\n      max-height: 76px;\n      overflow: hidden;\n      display: -webkit-box;\n      -webkit-line-clamp: 4;\n      -webkit-box-orient: vertical;\n    }\n    .card-tags {\n      display: flex;\n      flex-wrap: wrap;\n      gap: 5px;\n      margin-top: 8px;\n    }\n    .card-tag {\n      border-radius: 999px;\n      padding: 2px 7px;\n      font-size: 10px;\n      font-weight: 800;\n      line-height: 1.35;\n    }\n    .tag-not-ready { background: #e2e8f0; color: #475569; }\n    .tag-left-in-progress { background: #ffe4e6; color: #9f1239; }\n    .tag-unwritten { background: #fff4cc; color: #8a5a00; }\n    .tag-implementing { background: #ede9fe; color: #5b21b6; }\n    .tag-verifying { background: #fae8ff; color: #86198f; }\n    .tag-priority { background: #ffedd5; color: #9a3412; }\n\n    .empty-column {\n      color: #94a3b8;\n      font-size: 12px;\n      padding: 10px 4px;\n      text-align: center;\n    }\n\n    .modal-overlay {\n      position: fixed;\n      inset: 0;\n      background: rgba(15,23,42,0.58);\n      display: flex;\n      align-items: flex-start;\n      justify-content: center;\n      padding: 56px 16px 16px;\n      z-index: 100;\n    }\n    .modal-overlay.hidden { display: none; }\n\n    .modal {\n      background: white;\n      border-radius: 8px;\n      width: 100%;\n      max-width: 720px;\n      padding: 18px;\n      box-shadow: 0 14px 40px rgba(15,23,42,0.28);\n    }\n    .modal-header {\n      display: flex;\n      align-items: flex-start;\n      justify-content: space-between;\n      margin-bottom: 14px;\n      gap: 12px;\n    }\n    .modal-meta { flex: 1; min-width: 0; }\n    .modal-file {\n      font-size: 11px;\n      color: #7b8794;\n      margin-bottom: 4px;\n      overflow: hidden;\n      text-overflow: ellipsis;\n      white-space: nowrap;\n    }\n    .modal-section-label { font-size: 14px; font-weight: 700; color: #1f2933; }\n    .modal-status {\n      font-size: 11px;\n      font-weight: 800;\n      padding: 3px 8px;\n      border-radius: 999px;\n      text-transform: uppercase;\n      flex-shrink: 0;\n    }\n    .status-backlog { background: #e2e8f0; color: #475569; }\n    .status-low-priority { background: #ffedd5; color: #9a3412; }\n    .status-todo { background: #dbeafe; color: #1d4ed8; }\n    .status-in-progress { background: #ede9fe; color: #5b21b6; }\n    .status-done { background: #dcfce7; color: #166534; }\n    .status-errors { background: #fee2e2; color: #991b1b; }\n    .status-finished { background: #cffafe; color: #155e75; }\n    .modal-close {\n      background: transparent;\n      border: 0;\n      color: #64748b;\n      cursor: pointer;\n      font-size: 20px;\n      padding: 0 4px;\n      line-height: 1;\n    }\n    .modal-close:hover { color: #1f2933; }\n\n    textarea {\n      width: 100%;\n      min-height: 300px;\n      font-family: \"SFMono-Regular\", Consolas, \"Courier New\", monospace;\n      font-size: 13px;\n      border: 2px solid #d8dee8;\n      border-radius: 4px;\n      padding: 10px 12px;\n      resize: vertical;\n      line-height: 1.6;\n      color: #1f2933;\n    }\n    textarea:focus {\n      outline: none;\n      border-color: #2563eb;\n      box-shadow: 0 0 0 3px rgba(37,99,235,0.12);\n    }\n    .modal-actions {\n      display: flex;\n      gap: 8px;\n      margin-top: 14px;\n      justify-content: flex-end;\n    }\n\n    .error-banner {\n      background: #fee2e2;\n      border-bottom: 2px solid #b42318;\n      color: #991b1b;\n      padding: 8px 18px;\n      font-size: 13px;\n      font-weight: 700;\n    }\n    .error-banner.hidden { display: none; }\n\n    @media (max-width: 860px) {\n      header { flex-wrap: wrap; }\n      #pause-label { order: 4; flex-basis: 100%; }\n      .run-strip { grid-template-columns: 1fr; }\n      .board { min-height: calc(100vh - 212px); }\n    }\n  </style>\n</head>\n<body>\n  <div id=\"error-banner\" class=\"error-banner hidden\"></div>\n\n  <header>\n    <h1>Ptbk Coder Server</h1>\n    <span id=\"status-badge\" class=\"status-badge status-RUNNING\">RUNNING</span>\n    <span id=\"pause-label\"></span>\n    <button id=\"toggle-btn\" class=\"btn btn-pause\">Pause</button>\n  </header>\n\n  <section class=\"run-strip\">\n    <div>\n      <div class=\"run-title\" id=\"run-title\">Initializing...</div>\n      <div class=\"run-subtitle\" id=\"run-subtitle\">Loading runner state</div>\n    </div>\n    <div class=\"progress-shell\">\n      <div class=\"progress-track\"><span class=\"progress-fill\" id=\"progress-fill\"></span></div>\n      <div class=\"progress-label\" id=\"progress-label\">0%</div>\n    </div>\n    <div>\n      <div class=\"run-current\" id=\"run-current\">No active prompt</div>\n      <div class=\"run-output\" id=\"run-output\"></div>\n    </div>\n  </section>\n\n  <div class=\"board\" id=\"board\"></div>\n\n  <div class=\"modal-overlay hidden\" id=\"modal-overlay\">\n    <div class=\"modal\">\n      <div class=\"modal-header\">\n        <div class=\"modal-meta\">\n          <div class=\"modal-file\" id=\"modal-file\"></div>\n          <div class=\"modal-section-label\" id=\"modal-section-label\"></div>\n        </div>\n        <span class=\"modal-status\" id=\"modal-status-badge\"></span>\n        <button class=\"modal-close\" id=\"modal-close\" title=\"Close\">&times;</button>\n      </div>\n\n      <textarea id=\"modal-content\" placeholder=\"Prompt content\"></textarea>\n\n      <div class=\"modal-actions\">\n        <button class=\"btn btn-cancel\" id=\"cancel-button\">Cancel</button>\n        <button class=\"btn btn-save\" id=\"save-button\">Save</button>\n      </div>\n    </div>\n  </div>\n\n  <script>\n    \"use strict\";\n\n    const BOARD_COLUMNS = [\n      { id: \"backlog\", title: \"Backlog\" },\n      { id: \"low-priority\", title: \"Outside priority\" },\n      { id: \"todo\", title: \"To do\" },\n      { id: \"in-progress\", title: \"In progress\" },\n      { id: \"done\", title: \"Done\" },\n      { id: \"errors\", title: \"Errors\" },\n      { id: \"finished\", title: \"Finished\" },\n    ];\n\n    let modalState = null;\n    let lastPauseState = \"RUNNING\";\n\n    function getColumnTitle(columnId) {\n      const column = BOARD_COLUMNS.find((columnCandidate) => columnCandidate.id === columnId);\n      return column ? column.title : columnId;\n    }\n\n    function showError(message) {\n      const banner = document.getElementById(\"error-banner\");\n      banner.textContent = message;\n      banner.classList.remove(\"hidden\");\n      clearTimeout(banner.timer);\n      banner.timer = setTimeout(() => banner.classList.add(\"hidden\"), 6000);\n    }\n\n    function escapeHtml(value) {\n      const element = document.createElement(\"div\");\n      element.textContent = String(value);\n      return element.innerHTML;\n    }\n\n    function renderBoardSkeleton() {\n      const board = document.getElementById(\"board\");\n      board.innerHTML = \"\";\n\n      for (const column of BOARD_COLUMNS) {\n        const columnElement = document.createElement(\"section\");\n        columnElement.className = \"column column-\" + column.id;\n        columnElement.innerHTML =\n          '<div class=\"column-header\">' +\n            '<span>' + escapeHtml(column.title) + '</span>' +\n            '<span class=\"column-count\" id=\"count-' + column.id + '\">0</span>' +\n          '</div>' +\n          '<div class=\"column-cards\" id=\"cards-' + column.id + '\">' +\n            '<div class=\"empty-column\">Loading</div>' +\n          '</div>';\n        board.appendChild(columnElement);\n      }\n    }\n\n    async function fetchStatus() {\n      try {\n        const response = await fetch(\"/api/status\");\n        if (!response.ok) {\n          showError(\"Status API error: \" + response.status);\n          return;\n        }\n\n        const status = await response.json();\n        renderPauseState(status);\n        renderRunState(status.runState);\n      } catch (error) {\n        showError(\"Could not reach coder server: \" + error.message);\n      }\n    }\n\n    function renderPauseState(status) {\n      lastPauseState = status.pauseState;\n\n      const badge = document.getElementById(\"status-badge\");\n      badge.textContent = status.pauseState;\n      badge.className = \"status-badge status-\" + status.pauseState;\n\n      const toggleButton = document.getElementById(\"toggle-btn\");\n      const pauseLabel = document.getElementById(\"pause-label\");\n\n      if (status.pauseState === \"RUNNING\") {\n        toggleButton.textContent = \"Pause\";\n        toggleButton.className = \"btn btn-pause\";\n        pauseLabel.textContent = \"\";\n        return;\n      }\n\n      toggleButton.textContent = \"Resume\";\n      toggleButton.className = \"btn btn-resume\";\n      pauseLabel.textContent =\n        (status.pauseState === \"PAUSING\" ? \"Pausing before: \" : \"Paused before: \") +\n        (status.pauseTargetLabel || \"next checkpoint\");\n    }\n\n    function renderRunState(runState) {\n      if (!runState) {\n        document.getElementById(\"run-title\").textContent = \"Waiting for runner state\";\n        document.getElementById(\"run-subtitle\").textContent = \"\";\n        return;\n      }\n\n      const progress = runState.progress || {};\n      const percentage = Number(progress.percentage || 0);\n      const runnerParts = [runState.config.agentName, runState.config.modelName, runState.config.thinkingLevel]\n        .filter(Boolean);\n\n      document.getElementById(\"run-title\").textContent = runState.statusMessage || runState.phase;\n      document.getElementById(\"run-subtitle\").textContent = runnerParts.join(\" / \");\n      document.getElementById(\"progress-fill\").style.width = Math.max(0, Math.min(100, percentage)) + \"%\";\n      document.getElementById(\"progress-label\").textContent =\n        percentage + \"% \" + (progress.sessionDone || 0) + \"/\" + (progress.sessionTotal || 0);\n      document.getElementById(\"run-current\").textContent = runState.currentPromptLabel\n        ? runState.currentPromptLabel + \" - attempt \" + runState.currentAttempt + \"/\" + runState.maxAttempts\n        : \"No active prompt\";\n\n      renderRunOutput(runState);\n    }\n\n    function renderRunOutput(runState) {\n      const statusLines = (runState.agentStatusTableRows || []).map((row) =>\n        row.status + \" - \" + row.agentName + (row.url ? \" - \" + row.url : \"\")\n      );\n      const outputLines = [\n        ...(runState.agentStatusLines || []),\n        ...statusLines,\n        ...(runState.agentOutputLines || []),\n        ...(runState.errors || []).map((errorLine) => \"Error: \" + errorLine),\n      ].slice(-3);\n\n      document.getElementById(\"run-output\").textContent = outputLines.join(\"\\n\");\n    }\n\n    async function fetchPrompts() {\n      try {\n        const response = await fetch(\"/api/prompts\");\n        if (!response.ok) {\n          showError(\"Prompts API error: \" + response.status);\n          return;\n        }\n\n        renderBoard(await response.json());\n      } catch (error) {\n        showError(\"Could not load prompts: \" + error.message);\n      }\n    }\n\n    function renderBoard(promptFiles) {\n      const columns = Object.fromEntries(BOARD_COLUMNS.map((column) => [column.id, []]));\n\n      for (const file of promptFiles) {\n        for (const section of file.sections) {\n          if (columns[section.column]) {\n            columns[section.column].push({ file, section });\n          }\n        }\n      }\n\n      for (const column of BOARD_COLUMNS) {\n        renderColumn(column.id, columns[column.id]);\n      }\n    }\n\n    function renderColumn(columnId, cards) {\n      const container = document.getElementById(\"cards-\" + columnId);\n      const countElement = document.getElementById(\"count-\" + columnId);\n\n      countElement.textContent = cards.length;\n      container.innerHTML = \"\";\n\n      if (cards.length === 0) {\n        container.innerHTML = '<div class=\"empty-column\">Empty</div>';\n        return;\n      }\n\n      for (const cardData of cards) {\n        container.appendChild(createPromptCard(cardData.file, cardData.section));\n      }\n    }\n\n    function createPromptCard(file, section) {\n      const card = document.createElement(\"article\");\n      card.className = \"card card-\" + section.column;\n      card.innerHTML =\n        '<div class=\"card-file\">' + escapeHtml(file.relativeFilePath || file.fileName) + \" #\" + (section.index + 1) + '</div>' +\n        '<div class=\"card-summary\">' + escapeHtml(section.summary) + '</div>' +\n        renderTags(section);\n      card.onclick = () => openModal(file, section);\n      return card;\n    }\n\n    function renderTags(section) {\n      const tags = [...(section.tags || [])];\n      if (section.priority > 0) {\n        tags.push({ id: \"priority\", label: \"P\" + section.priority });\n      }\n\n      if (tags.length === 0) {\n        return \"\";\n      }\n\n      return '<div class=\"card-tags\">' + tags.map((tag) =>\n        '<span class=\"card-tag tag-' + escapeHtml(tag.id) + '\">' + escapeHtml(tag.label) + '</span>'\n      ).join(\"\") + '</div>';\n    }\n\n    function openModal(file, section) {\n      modalState = { filePath: file.filePath, sectionIndex: section.index };\n\n      document.getElementById(\"modal-file\").textContent = file.relativeFilePath || file.fileName;\n      document.getElementById(\"modal-section-label\").textContent = \"Section \" + (section.index + 1);\n\n      const statusBadge = document.getElementById(\"modal-status-badge\");\n      statusBadge.textContent = getColumnTitle(section.column);\n      statusBadge.className = \"modal-status status-\" + section.column;\n\n      document.getElementById(\"modal-content\").value = section.content;\n      document.getElementById(\"modal-overlay\").classList.remove(\"hidden\");\n      setTimeout(() => document.getElementById(\"modal-content\").focus(), 50);\n    }\n\n    function closeModal() {\n      document.getElementById(\"modal-overlay\").classList.add(\"hidden\");\n      modalState = null;\n    }\n\n    async function saveModal() {\n      if (!modalState) {\n        return;\n      }\n\n      const content = document.getElementById(\"modal-content\").value;\n      const saveButton = document.getElementById(\"save-button\");\n      saveButton.disabled = true;\n      saveButton.textContent = \"Saving...\";\n\n      try {\n        const response = await fetch(\"/api/prompts/update\", {\n          method: \"PUT\",\n          headers: { \"Content-Type\": \"application/json\" },\n          body: JSON.stringify({\n            filePath: modalState.filePath,\n            sectionIndex: modalState.sectionIndex,\n            content,\n          }),\n        });\n\n        if (!response.ok) {\n          throw new Error(\"HTTP \" + response.status);\n        }\n\n        closeModal();\n        await fetchPrompts();\n      } catch (error) {\n        showError(\"Save failed: \" + error.message);\n      } finally {\n        saveButton.disabled = false;\n        saveButton.textContent = \"Save\";\n      }\n    }\n\n    document.getElementById(\"toggle-btn\").onclick = async () => {\n      try {\n        const endpoint = lastPauseState === \"RUNNING\" ? \"/api/pause\" : \"/api/resume\";\n        await fetch(endpoint, { method: \"POST\" });\n        await fetchStatus();\n      } catch (error) {\n        showError(\"Toggle failed: \" + error.message);\n      }\n    };\n\n    document.getElementById(\"modal-close\").onclick = closeModal;\n    document.getElementById(\"cancel-button\").onclick = closeModal;\n    document.getElementById(\"save-button\").onclick = saveModal;\n\n    document.addEventListener(\"keydown\", (event) => {\n      if (event.key === \"Escape\") {\n        closeModal();\n        return;\n      }\n      if ((event.ctrlKey || event.metaKey) && event.key === \"Enter\") {\n        saveModal();\n      }\n    });\n\n    document.getElementById(\"modal-overlay\").addEventListener(\"click\", (event) => {\n      if (event.target === document.getElementById(\"modal-overlay\")) {\n        closeModal();\n      }\n    });\n\n    renderBoardSkeleton();\n    fetchStatus();\n    fetchPrompts();\n    setInterval(fetchStatus, 2000);\n    setInterval(fetchPrompts, 5000);\n  </script>\n</body>\n</html>\n";
+export declare const CODER_SERVER_HTML: string;

package/esm/scripts/run-codex-prompts/ui/buildCoderRunAgentVisual.d.ts

@@ -28,12 +28,12 @@ export type CoderRunAgentVisual = TerminalAgentAvatarVisual;
  * Builds the ANSI ASCII-art visual of the `--agent` book shown above the coder-run dashboard.
  *
  * The agent's avatar visual is resolved the same way as on the website - the `META AVATAR`
- * commitment wins, then the `META VISUAL` commitment, then the shared default visual - and is
- * rendered dynamically through the shared canvas avatar pipeline into terminal ASCII art.
- * The terminal variant uses a transparent horizontal canvas instead of the website's framed 1:1 surface.
+ * commitment wins, then the `META VISUAL` commitment, then the shared default visual.
+ * Character-based visuals such as `AsciiOctopus` paint the terminal grid directly, while pixel-based
+ * visuals are rendered through the shared canvas avatar pipeline into terminal ASCII art, using a
+ * transparent horizontal canvas instead of the website's framed 1:1 surface.
  *
- * The visual is decorative, so any failure (for example when the optional `@napi-rs/canvas`
- * module is not installed) returns `null` and the caller keeps the default brand banner.
+ * The visual is decorative, so any failure returns `null` and the caller keeps the default brand banner.
  *
  * @param agentSource Source of the `--agent` book file.
  * @returns ANSI-colored ASCII-art renderer or `null` when the visual cannot be rendered.

package/esm/scripts/run-codex-prompts/ui/buildCoderRunUiTerminalFrameUpdate.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Builds the terminal output required to replace the previous coder-run frame with the next one.
+ *
+ * The complete update is returned as one string so callers can write it atomically. This prevents
+ * animated visuals from producing a separate terminal write for every changed row, which otherwise
+ * leaves a large rendering backlog in terminal emulators while their window is not focused.
+ *
+ * @private internal utility of coder run UI
+ */
+export type BuildCoderRunUiTerminalFrameUpdateOptions = {
+    /** Frame currently displayed in the terminal, with the cursor on its last row. */
+    readonly previousFrameLines: readonly string[];
+    /** Frame that should replace the currently displayed frame. */
+    readonly nextFrameLines: readonly string[];
+};
+/**
+ * Builds one atomic ANSI update that changes the displayed coder-run terminal frame.
+ *
+ * A change in frame height requires a full rewrite to reserve or clear rows correctly. Frames with
+ * the same height only rewrite contiguous groups of changed rows, returning to the frame bottom
+ * between groups so each group can be assembled into the same output payload safely.
+ *
+ * @returns One terminal output payload, or `undefined` when the frame is already up to date.
+ *
+ * @private internal utility of coder run UI
+ */
+export declare function buildCoderRunUiTerminalFrameUpdate(options: BuildCoderRunUiTerminalFrameUpdateOptions): string | undefined;

package/esm/src/avatars/renderAvatarVisualTerminalText.d.ts

@@ -0,0 +1,80 @@
+import type { AsciiArtColorDepth } from '../utils/ascii-art/convertImageDataToAsciiArt';
+import type { ResolvedAvatarRenderDefinition } from './renderAvatarVisual';
+import type { AvatarDefinition } from './types/AvatarDefinition';
+import type { AvatarSurfaceStyle, AvatarVisualId, AvatarVisualTerminalTextGrid } from './types/AvatarVisualDefinition';
+/**
+ * Options shared by the terminal-text avatar renderers.
+ *
+ * @private within the repository
+ */
+export type RenderAvatarVisualTerminalTextOptions = {
+    /**
+     * Stable visual identity of the rendered agent avatar.
+     */
+    readonly avatarDefinition: AvatarDefinition;
+    /**
+     * Built-in avatar visual to render, the same one used on the website.
+     */
+    readonly visualId: AvatarVisualId;
+    /**
+     * Surface used to derive the avatar palette.
+     *
+     * @default 'framed'
+     */
+    readonly surface?: AvatarSurfaceStyle;
+    /**
+     * Output width in terminal character cells.
+     */
+    readonly columns: number;
+    /**
+     * Output height in terminal character cells.
+     */
+    readonly rows: number;
+    /**
+     * Animation timestamp for animated visuals.
+     */
+    readonly timeMs: number;
+    /**
+     * Optional stable render data reused across frames.
+     */
+    readonly resolvedAvatarRenderDefinition?: ResolvedAvatarRenderDefinition;
+};
+/**
+ * Options for `renderAvatarVisualTerminalTextLines`.
+ *
+ * @private within the repository
+ */
+export type RenderAvatarVisualTerminalTextLinesOptions = RenderAvatarVisualTerminalTextOptions & {
+    /**
+     * Color depth of the emitted ANSI escape codes.
+     *
+     * @default 'TRUE_COLOR'
+     */
+    readonly colorDepth?: AsciiArtColorDepth;
+};
+/**
+ * Renders one frame of a character-based avatar visual straight into terminal character cells.
+ *
+ * Visuals which are themselves made of characters, for example `AsciiOctopus`, lose their identity
+ * when they are rasterized onto a canvas and converted back into half-block ASCII art - every glyph
+ * is averaged away into a colored blob. Such visuals expose `renderTerminalText`, which paints the
+ * terminal grid directly and is used instead of the raster pipeline.
+ *
+ * The square avatar is centered inside the requested grid the same way `renderAvatarVisualAsciiArt`
+ * centers the avatar canvas inside a wider terminal frame.
+ *
+ * @param options Avatar identity, visual selection, and output grid size.
+ * @returns Grid of `rows` rows of `columns` cells, or `null` when the visual has no terminal renderer.
+ *
+ * @private within the repository
+ */
+export declare function renderAvatarVisualTerminalTextGrid(options: RenderAvatarVisualTerminalTextOptions): AvatarVisualTerminalTextGrid | null;
+/**
+ * Renders one frame of a character-based avatar visual into ANSI-colored terminal lines.
+ *
+ * @param options Avatar identity, visual selection, output grid size, and ANSI color depth.
+ * @returns One ANSI-colored string per output row, or `null` when the visual has no terminal renderer.
+ *
+ * @private within the repository
+ */
+export declare function renderAvatarVisualTerminalTextLines(options: RenderAvatarVisualTerminalTextLinesOptions): ReadonlyArray<string> | null;

package/esm/src/avatars/types/AvatarVisualDefinition.d.ts

@@ -72,6 +72,52 @@ export type AvatarVisualRenderContext = {
  * @private shared contract for the avatar rendering system
  */
 export type AvatarVisual = (context: AvatarVisualRenderContext) => void;
+/**
+ * One painted character cell of a terminal-text avatar frame.
+ *
+ * @private shared contract for the avatar rendering system
+ */
+export type AvatarVisualTerminalTextCell = {
+    /**
+     * Single character painted in the cell.
+     */
+    readonly character: string;
+    /**
+     * Color of the character as a CSS color string, optionally with an alpha channel.
+     */
+    readonly color: string_color;
+};
+/**
+ * One rendered terminal-text avatar frame as a grid of character cells.
+ *
+ * Rows are ordered top to bottom, cells left to right, and `null` leaves the terminal background visible.
+ *
+ * @private shared contract for the avatar rendering system
+ */
+export type AvatarVisualTerminalTextGrid = ReadonlyArray<ReadonlyArray<AvatarVisualTerminalTextCell | null>>;
+/**
+ * Rendering context forwarded to a terminal-text avatar visual.
+ *
+ * Unlike `AvatarVisualRenderContext` this carries no canvas, because the visual paints
+ * character cells of a fixed terminal grid instead of pixels.
+ *
+ * @private shared contract for the avatar rendering system
+ */
+export type AvatarVisualTerminalTextRenderContext = {
+    readonly columns: number;
+    readonly rows: number;
+    readonly timeMs: number;
+    readonly avatarDefinition: AvatarDefinition;
+    readonly palette: AvatarPalette;
+    readonly createRandom: (salt: string) => () => number;
+    readonly interaction: AvatarInteractionState;
+};
+/**
+ * Signature of one terminal-text avatar visual renderer.
+ *
+ * @private shared contract for the avatar rendering system
+ */
+export type AvatarVisualTerminalText = (context: AvatarVisualTerminalTextRenderContext) => AvatarVisualTerminalTextGrid;
 /**
  * Metadata and renderer for one built-in avatar visual.
  *
@@ -84,6 +130,14 @@ export type AvatarVisualDefinition = {
     readonly isAnimated: boolean;
     readonly supportsPointerTracking?: boolean;
     readonly render: AvatarVisual;
+    /**
+     * Optional native terminal renderer of visuals which are themselves made of characters.
+     *
+     * Character-based visuals lose their identity when they are rasterized onto a canvas and
+     * converted back into half-block ASCII art, so they paint the terminal character grid directly.
+     * Visuals without this renderer are rasterized through `renderAvatarVisualAsciiArt` instead.
+     */
+    readonly renderTerminalText?: AvatarVisualTerminalText;
 };
 /**
  * Props of the shared `<Avatar/>` component.

package/esm/src/book-3.0/AgentTeamConversationWorkspace.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Relative directory for an active TEAM conversation workspace.
+ *
+ * @private internal convention shared by the Agents Server and agent-folder runner
+ */
+export declare const AGENT_TEAM_CONVERSATIONS_DIRECTORY_PATH: string;
+/**
+ * Relative directory where completed TEAM conversation transcripts are retained.
+ *
+ * @private internal convention shared by the Agents Server and agent-folder runner
+ */
+export declare const AGENT_FINISHED_TEAM_CONVERSATIONS_DIRECTORY_PATH: string;
+/**
+ * Name of the JSON manifest that describes one TEAM conversation workspace.
+ *
+ * @private internal convention shared by the Agents Server and agent-folder runner
+ */
+export declare const AGENT_TEAM_CONVERSATION_MANIFEST_FILE_NAME = "team.json";
+/**
+ * Name of the read-only teammate-source directory inside one TEAM workspace.
+ *
+ * @private internal convention shared by the Agents Server and agent-folder runner
+ */
+export declare const AGENT_TEAMMATE_SOURCES_DIRECTORY_NAME = "teammates";
+/**
+ * One primary agent represented in a TEAM workspace manifest.
+ *
+ * @private internal convention shared by the Agents Server and agent-folder runner
+ */
+export type AgentTeamConversationPrimaryAgent = {
+    readonly permanentId: string;
+    readonly agentName: string;
+};
+/**
+ * One local teammate made available to the coding harness for a single user turn.
+ *
+ * @private internal convention shared by the Agents Server and agent-folder runner
+ */
+export type AgentTeamConversationTeammate = {
+    readonly permanentId: string;
+    readonly agentName: string;
+    readonly url: string;
+    readonly instructions: string;
+    readonly sourceFileName: string;
+};
+/**
+ * Persisted roster snapshot for the optional TEAM workspace of one queued message.
+ *
+ * @private internal convention shared by the Agents Server and agent-folder runner
+ */
+export type AgentTeamConversationWorkspaceManifest = {
+    readonly version: 1;
+    readonly primaryAgent: AgentTeamConversationPrimaryAgent;
+    readonly teammates: ReadonlyArray<AgentTeamConversationTeammate>;
+};
+/**
+ * Creates the stable directory name that belongs to one queued `.book` message.
+ *
+ * @private internal convention shared by the Agents Server and agent-folder runner
+ */
+export declare function createAgentTeamConversationWorkspaceDirectoryName(messageFileName: string): string;
+/**
+ * Creates the relative active workspace path for one queued message.
+ *
+ * @private internal convention shared by the Agents Server and agent-folder runner
+ */
+export declare function createAgentTeamConversationWorkspacePath(messageFileName: string): string;
+/**
+ * Creates the relative completed-workspace path for one queued message.
+ *
+ * @private internal convention shared by the Agents Server and agent-folder runner
+ */
+export declare function createFinishedAgentTeamConversationWorkspacePath(messageFileName: string): string;
+/**
+ * Creates the source-snapshot file name for one teammate.
+ *
+ * @private internal convention shared by the Agents Server and agent-folder runner
+ */
+export declare function createAgentTeamTeammateSourceFileName(teammatePermanentId: string): string;
+/**
+ * Checks whether unknown JSON has the minimum shape required for a TEAM workspace manifest.
+ *
+ * @private internal convention shared by the Agents Server and agent-folder runner
+ */
+export declare function isAgentTeamConversationWorkspaceManifest(value: unknown): value is AgentTeamConversationWorkspaceManifest;

package/esm/src/book-components/Chat/Chat/ChatProps.d.ts

@@ -591,8 +591,9 @@ export type ChatProps = {
         progress?: number;
     }>;
     /**
-     * Content to be shown inside the chat bar in head
-     * If not provided, the chat bar will not be rendered
+     * Optional content displayed in the chat header above the message list.
+     *
+     * If not provided, the header row is not rendered.
      */
     readonly children?: ReactNode;
     /**

package/esm/src/book-components/Chat/utils/renderMarkdown.d.ts

@@ -17,6 +17,13 @@ export type MarkdownInlineReference = {
      * Raw reference text between `[[` and `]]`.
      */
     readonly reference: string;
+    /**
+     * Optional text aliases which should render as this reference when an agent mentions them in markdown.
+     *
+     * They are also accepted inside a `[[reference]]` token. This lets application code use a stable
+     * technical reference while recognizing a human-facing name in older messages.
+     */
+    readonly sourceTextAliases?: ReadonlyArray<string>;
     /**
      * Human-readable label rendered inside the link chip.
      */
@@ -26,10 +33,12 @@ export type MarkdownInlineReference = {
      */
     readonly href: string;
     /**
-     * Markdown link destination prefixes that should render as this reference as well.
+     * Optional URL prefixes which also identify this reference in the authored markdown.
      *
-     * This supports legacy links such as an Agents Server project file URL while keeping
-     * `reference` as the canonical `[[project]]` token.
+     * A markdown link or a bare URL pointing to one of these prefixes is rendered as the same chip
+     * as the `[[reference]]` token. Both absolute URLs (for example `https://project.example.com`)
+     * and application paths (for example `/agents/agent/projects/website`) are supported; a path
+     * prefix matches on any host so that both relative and absolute links are recognized.
      */
     readonly sourceHrefPrefixes?: ReadonlyArray<string>;
     /**

package/esm/src/cli/cli-commands/coder/boilerplateCount.d.ts

@@ -12,7 +12,7 @@ export type BoilerplateCount = {
      * Number of prompts written into each generated file.
      *
      * Note: More than one prompt per file is an advanced option - each prompt is one separate
-     *       coding task separated by `---` and tagged with its own fresh emoji tag.
+     *       coding task separated by `---`, with all prompts in the file sharing its fresh emoji tag.
      */
     readonly promptsPerFileCount: number;
 };

package/esm/src/cli/cli-commands/coder/generate-boilerplates.d.ts

@@ -10,7 +10,7 @@ import type { BoilerplateCount } from './boilerplateCount';
  */
 export declare function $initializeCoderGenerateBoilerplatesCommand(program: Program): $side_effect;
 /**
- * Generates boilerplate prompt files with unique emoji tags.
+ * Generates boilerplate prompt files with one unique emoji tag per file.
  *
  * @private internal function of `generatePromptBoilerplate` command
  */

package/esm/src/cli/cli-commands/common/{harness/$askForHarnessInstallationApproval.d.ts → npm/$askForNpmPackageInstallationApproval.d.ts}

@@ -1,9 +1,9 @@
 /**
- * Asks the user in the terminal whether the harness should be installed or updated right now.
+ * Asks the user in the terminal whether an npm package should be installed or updated now.
  *
  * Note: `$` is used to indicate that this function is not a pure function - it reads the answer from stdin
  *
  * @returns `true` when the user confirms, `false` when the user declines or the terminal is not interactive
  * @private internal utility of `promptbookCli`
  */
-export declare function $askForHarnessInstallationApproval(question: string): Promise<boolean>;
+export declare function $askForNpmPackageInstallationApproval(question: string): Promise<boolean>;

package/{umd/src/cli/cli-commands/common/harness/$resolveLatestHarnessVersion.d.ts → esm/src/cli/cli-commands/common/npm/$resolveLatestNpmPackageVersion.d.ts}

@@ -1,10 +1,9 @@
-import type { HarnessDefinition } from './HarnessDefinition';
 /**
- * Reads the newest version of the harness published to npm.
+ * Reads the newest version of one npm package.
  *
  * Note: `$` is used to indicate that this function is not a pure function - it queries the npm registry
  *
  * @returns The newest published version or `null` when the registry could not be reached
  * @private internal utility of `promptbookCli`
  */
-export declare function $resolveLatestHarnessVersion(definition: HarnessDefinition): Promise<string | null>;
+export declare function $resolveLatestNpmPackageVersion(npmPackageName: string): Promise<string | null>;