@astralform/js 7.4.1 → 7.5.1

package/dist/index.cjs

@@ -389,15 +389,16 @@ function isApiKeyConfig(config) {
 }
 var AstralformClient = class {
   constructor(config) {
-    // --- Code mode: the app user's projects ---
+    // --- Projects: the repositories this app user works with ---
     /**
      * The projects (GitHub repositories) this app user works with, and what they
      * may add.
      *
-     * A project list is per app user within a code-mode agent: the developer
-     * connects the workspace's GitHub account, and each user curates their own
-     * list from what that connection covers. Every method 404s on a chat-mode
-     * agent, so the surface is invisible rather than empty there.
+     * A project list is per app user: the developer connects the workspace's GitHub
+     * account, and each user curates their own list from what that connection
+     * covers. There is no agent-level gate — an agent with no GitHub lists nothing,
+     * reports `not_installed` from `available()`, and refuses `add()`. Read
+     * {@link AgentInfo.codeProjectsEnabled} to decide whether to show the surface.
      */
     this.code = {
       projects: {
@@ -695,9 +696,10 @@ var AstralformClient = class {
   /**
    * A page of conversations, newest-updated first.
    *
-   * `options.repository` narrows to one project's tasks (`owner/repo`) on a
-   * code-mode agent — the same paging applies within the filter, so a client
-   * showing tasks per project pages each project separately.
+   * `options.repository` narrows to one project's tasks (`owner/repo`) — the same
+   * paging applies within the filter, so a client showing tasks per project pages
+   * each project separately. Tasks that named no repository fall outside every
+   * such filter; list them with no filter at all.
    */
   async getConversations(limit = 50, offset = 0, options) {
     const safeLimit = Math.max(1, Math.min(200, Math.floor(Number(limit))));
@@ -1798,7 +1800,7 @@ var ChatSession = class {
       image_mode: options?.imageMode,
       video_mode: options?.videoMode,
       goal: options?.goal,
-      // The project this task belongs to, on a code-mode agent. Write-once
+      // The project this task belongs to, when it has one. Write-once
       // server-side: sent on every turn, honoured on the first.
       repository: options?.repository,
       // Per-request model choice (client-side model selection).
@@ -2936,23 +2938,41 @@ var StreamManager = class {
     }
   }
   // ── Internal: restore ─────────────────────────────────────────
+  /**
+   * A conversation's turns, oldest first.
+   *
+   * Its own method so ``restore`` can put the request on the wire beside the
+   * probe and the message list while ``replayHistory``, which consumes it,
+   * keeps owning the shape it reads.
+   */
+  jobList(conversationId) {
+    return this.session.client.get(
+      `/v1/conversations/${encodeURIComponent(conversationId)}/jobs`
+    );
+  }
   async restore(conversationId, gen) {
     const superseded = () => gen !== this.generation;
     if (superseded()) return;
     const turn = this.turnCounter;
     const announcedRestoring = !this.session.isStreaming;
     if (announcedRestoring) this.setState("restoring");
-    let activeJobId = null;
-    try {
-      const res = await this.session.client.getActiveJob(conversationId);
-      activeJobId = res.jobId;
-    } catch {
-    }
     if (superseded()) return;
-    await this.session.loadConversation(conversationId);
+    const probeRequest = this.session.client.getActiveJob(conversationId).catch(() => null);
+    const loadRequest = this.session.loadConversation(conversationId);
+    const jobsRequest = announcedRestoring ? this.jobList(conversationId) : null;
+    void jobsRequest?.catch(() => {
+    });
+    const [probe] = await Promise.all([probeRequest, loadRequest]);
+    const activeJobId = probe?.jobId ?? null;
     if (superseded()) return;
     if (announcedRestoring && this.viewTakenOverByLiveTurn()) return;
-    if (announcedRestoring && !await this.replayHistory(conversationId, gen, activeJobId, turn))
+    if (jobsRequest && !await this.replayHistory(
+      conversationId,
+      gen,
+      activeJobId,
+      turn,
+      jobsRequest
+    ))
       return;
     if (activeJobId) {
       this.setState("streaming");
@@ -3010,11 +3030,17 @@ var StreamManager = class {
    * that started it, which is emitted as a bubble with no events — the whole
    * reason a conversation reopened mid-turn now shows the message that started
    * that turn.
+   *
+   * ``jobsRequest`` is the job list already IN FLIGHT — issued by ``restore``
+   * alongside the probe and the message list rather than fetched here, so the
+   * three round trips overlap. It is awaited inside the try below, which is
+   * what keeps a failed job list non-blocking exactly as it was when the fetch
+   * lived here.
    */
-  async replayHistory(conversationId, gen, activeJobId, turn) {
+  async replayHistory(conversationId, gen, activeJobId, turn, jobsRequest) {
     const stopReplay = () => gen !== this.generation || this.viewTakenOverByLiveTurn() || this.turnStarted(turn);
     try {
-      const jobs = await this.session.client.get(`/v1/conversations/${encodeURIComponent(conversationId)}/jobs`);
+      const jobs = await jobsRequest;
       if (stopReplay()) return false;
       const replayableJobs = jobs.filter(
         (j) => j.job_id !== activeJobId