@astralform/js 7.5.0 → 8.0.0

package/dist/index.d.cts

@@ -566,7 +566,7 @@ interface Conversation {
     /**
      * The project this task belongs to (`owner/repo`), or `null` for an ordinary
      * conversation. Set on the first turn and immutable after. Absent (rather than
-     * null) from an Astralform older than 0.70.0.
+     * null) from an Astralform older than 0.69.46.
      */
     repository?: string | null;
 }
@@ -625,8 +625,9 @@ interface AgentInfo {
      * Derived by the server from the connector, so it cannot go stale the way the
      * retired `mode` toggle could. It gates a SURFACE, not an ability: naming a
      * repository is optional on every task, and a task that names none is an
-     * ordinary chat. Absent on Astralform older than 0.71.0 — fall back to `mode`
-     * there.
+     * ordinary chat. Absent on Astralform older than 0.69.50, where it should be
+     * read as false: those backends had an agent-level mode instead, and this
+     * SDK no longer carries the field that expressed it.
      *
      * It is a property of the WORKSPACE, not of a persona: `GET /v1/agents` selects
      * the workspace row itself and returns exactly one entry, so read
@@ -634,17 +635,6 @@ interface AgentInfo {
      * carry it, so a client learns this after opening an agent.
      */
     codeProjectsEnabled?: boolean;
-    /**
-     * @deprecated Removed in the next Astralform release. There is no agent mode —
-     * a repository belongs to the TASK, so one agent answers general questions and
-     * works in repositories from the same list. Read {@link codeProjectsEnabled}.
-     *
-     * Still reported for one release, as the STORED value of the retired column, so
-     * clients built before the change keep behaving exactly as they did. Do not
-     * treat it as an alias for `codeProjectsEnabled`: an agent that never had the
-     * toggle set still reports `"chat"` while its tasks can bind perfectly well.
-     */
-    mode?: "chat" | "code";
 }
 interface TeamSummary {
     id: string;
@@ -778,9 +768,9 @@ interface ChatStreamRequest {
      * later turn may omit it or repeat the same value; a DIFFERENT value is refused
      * (409), not ignored — a task is bound to one repository for life, so a
      * different repository means a new task. A task that never names one is an
-     * ordinary chat; since Astralform 0.71.0 there is no agent mode that requires
+     * ordinary chat; since Astralform 0.69.50 there is no agent mode that requires
      * one.
-     * Astralform >= 0.70.0.
+     * Astralform >= 0.69.46.
      */
     repository?: string;
     mcp_manifest?: ToolDefinition[];
@@ -1085,8 +1075,8 @@ interface SendOptions$1 extends ModelChoiceOptions {
      * Send it on the turn that STARTS a task; the binding is write-once, so a
      * later turn may omit it or repeat the same value, and a DIFFERENT value is
      * refused (409) rather than ignored. Omit it entirely and the task is an
-     * ordinary chat — since Astralform 0.71.0 no agent requires one, and a first
-     * turn without it is no longer a 400. Astralform >= 0.70.0.
+     * ordinary chat — since Astralform 0.69.50 no agent requires one, and a first
+     * turn without it is no longer a 400. Astralform >= 0.69.46.
      */
     repository?: string;
 }
@@ -1845,8 +1835,8 @@ interface SendOptions extends ModelChoiceOptions {
      * repeat the same value, and a DIFFERENT value is refused (409) rather than
      * ignored — silently acting on the wrong repository is the failure that rule
      * exists to prevent. Omit it entirely and the task is an ordinary chat: since
-     * Astralform 0.71.0 there is no agent mode that requires one, so a first turn
-     * without it is no longer a 400. Astralform >= 0.70.0.
+     * Astralform 0.69.50 there is no agent mode that requires one, so a first turn
+     * without it is no longer a 400. Astralform >= 0.69.46.
      */
     repository?: string;
 }
@@ -2018,6 +2008,14 @@ declare class StreamManager {
      */
     private settleIdle;
     private finalizeStream;
+    /**
+     * 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.
+     */
+    private jobList;
     private restore;
     /**
      * Has a live turn taken the block view over?
@@ -2056,6 +2054,12 @@ declare class StreamManager {
      * 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.
      */
     private replayHistory;
     private setActiveConversation;

package/dist/index.d.ts

@@ -566,7 +566,7 @@ interface Conversation {
     /**
      * The project this task belongs to (`owner/repo`), or `null` for an ordinary
      * conversation. Set on the first turn and immutable after. Absent (rather than
-     * null) from an Astralform older than 0.70.0.
+     * null) from an Astralform older than 0.69.46.
      */
     repository?: string | null;
 }
@@ -625,8 +625,9 @@ interface AgentInfo {
      * Derived by the server from the connector, so it cannot go stale the way the
      * retired `mode` toggle could. It gates a SURFACE, not an ability: naming a
      * repository is optional on every task, and a task that names none is an
-     * ordinary chat. Absent on Astralform older than 0.71.0 — fall back to `mode`
-     * there.
+     * ordinary chat. Absent on Astralform older than 0.69.50, where it should be
+     * read as false: those backends had an agent-level mode instead, and this
+     * SDK no longer carries the field that expressed it.
      *
      * It is a property of the WORKSPACE, not of a persona: `GET /v1/agents` selects
      * the workspace row itself and returns exactly one entry, so read
@@ -634,17 +635,6 @@ interface AgentInfo {
      * carry it, so a client learns this after opening an agent.
      */
     codeProjectsEnabled?: boolean;
-    /**
-     * @deprecated Removed in the next Astralform release. There is no agent mode —
-     * a repository belongs to the TASK, so one agent answers general questions and
-     * works in repositories from the same list. Read {@link codeProjectsEnabled}.
-     *
-     * Still reported for one release, as the STORED value of the retired column, so
-     * clients built before the change keep behaving exactly as they did. Do not
-     * treat it as an alias for `codeProjectsEnabled`: an agent that never had the
-     * toggle set still reports `"chat"` while its tasks can bind perfectly well.
-     */
-    mode?: "chat" | "code";
 }
 interface TeamSummary {
     id: string;
@@ -778,9 +768,9 @@ interface ChatStreamRequest {
      * later turn may omit it or repeat the same value; a DIFFERENT value is refused
      * (409), not ignored — a task is bound to one repository for life, so a
      * different repository means a new task. A task that never names one is an
-     * ordinary chat; since Astralform 0.71.0 there is no agent mode that requires
+     * ordinary chat; since Astralform 0.69.50 there is no agent mode that requires
      * one.
-     * Astralform >= 0.70.0.
+     * Astralform >= 0.69.46.
      */
     repository?: string;
     mcp_manifest?: ToolDefinition[];
@@ -1085,8 +1075,8 @@ interface SendOptions$1 extends ModelChoiceOptions {
      * Send it on the turn that STARTS a task; the binding is write-once, so a
      * later turn may omit it or repeat the same value, and a DIFFERENT value is
      * refused (409) rather than ignored. Omit it entirely and the task is an
-     * ordinary chat — since Astralform 0.71.0 no agent requires one, and a first
-     * turn without it is no longer a 400. Astralform >= 0.70.0.
+     * ordinary chat — since Astralform 0.69.50 no agent requires one, and a first
+     * turn without it is no longer a 400. Astralform >= 0.69.46.
      */
     repository?: string;
 }
@@ -1845,8 +1835,8 @@ interface SendOptions extends ModelChoiceOptions {
      * repeat the same value, and a DIFFERENT value is refused (409) rather than
      * ignored — silently acting on the wrong repository is the failure that rule
      * exists to prevent. Omit it entirely and the task is an ordinary chat: since
-     * Astralform 0.71.0 there is no agent mode that requires one, so a first turn
-     * without it is no longer a 400. Astralform >= 0.70.0.
+     * Astralform 0.69.50 there is no agent mode that requires one, so a first turn
+     * without it is no longer a 400. Astralform >= 0.69.46.
      */
     repository?: string;
 }
@@ -2018,6 +2008,14 @@ declare class StreamManager {
      */
     private settleIdle;
     private finalizeStream;
+    /**
+     * 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.
+     */
+    private jobList;
     private restore;
     /**
      * Has a live turn taken the block view over?
@@ -2056,6 +2054,12 @@ declare class StreamManager {
      * 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.
      */
     private replayHistory;
     private setActiveConversation;

package/dist/index.js

@@ -2887,23 +2887,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");
@@ -2961,11 +2979,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