@astralform/js 9.3.0 → 9.4.1

package/dist/index.cjs

@@ -500,6 +500,79 @@ var AstralformClient = class {
             `/v1/code/projects/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}`
           );
         }
+      },
+      /**
+       * Code groups: a user-named container under one repository, for a feature
+       * whose work outlives a single session. Its sessions share one plan and one
+       * set of notes, so what one writes the others read.
+       *
+       * A group is a LABEL, not a binding — unlike a task's project, which is
+       * written once on the first turn. A task may join, move between, or leave
+       * groups at any time, and a deleted group's sessions survive as ungrouped.
+       *
+       * The server enforces three things worth knowing before you render a
+       * failure: a group that is not this user's answers `404` (never `403`, so a
+       * group id cannot be probed); filing a task into a group under a DIFFERENT
+       * repository than the task's answers `409`; and the group's plan and notes
+       * are deleted with the group, while each session keeps its own.
+       */
+      groups: {
+        /**
+         * This user's groups, oldest first. Pass a repository to narrow to one
+         * repository's — the composer's picker does; the sidebar asks once and
+         * nests them itself.
+         */
+        list: async (repository) => {
+          const query = repository ? `?repository=${encodeURIComponent(repository)}` : "";
+          const raw = await this.get(`/v1/code/groups${query}`);
+          return raw.map((g) => camelizeKeys(g));
+        },
+        /**
+         * Create a group under a repository. The repository goes through the same
+         * normaliser the Projects surface uses, so a pasted GitHub URL is accepted
+         * and anything that is not `owner/repo` is refused.
+         */
+        create: async (repository, title) => {
+          const raw = await this.post("/v1/code/groups", { repository, title });
+          return camelizeKeys(raw);
+        },
+        /** Rename a group. A group that is not this user's answers `404`. */
+        rename: async (groupId, title) => {
+          const raw = await this.patch(`/v1/code/groups/${encodeURIComponent(groupId)}`, { title });
+          return camelizeKeys(raw);
+        },
+        /**
+         * Delete a group. Its tasks survive and become ungrouped, each keeping its
+         * own plan and notes; the group's SHARED documents are deleted with it.
+         */
+        remove: async (groupId) => {
+          await this.del(`/v1/code/groups/${encodeURIComponent(groupId)}`);
+        },
+        /**
+         * File a task into a group. Idempotent — filing an already-filed task
+         * again is the same state, not an error. Refused with `409` when the task
+         * belongs to a different repository than the group, because it would
+         * render nowhere in the sidebar.
+         */
+        assign: async (groupId, conversationId) => {
+          const raw = await this.post(
+            `/v1/code/groups/${encodeURIComponent(groupId)}/tasks/${encodeURIComponent(conversationId)}`,
+            void 0
+          );
+          return camelizeKeys(raw);
+        },
+        /**
+         * Take a task out of its group. The task and its documents are untouched.
+         *
+         * Deliberately not strict about WHICH group the task is in: a task that is
+         * in a different one (or in none) already satisfies "this task should not
+         * be grouped", so the call clears it rather than refusing.
+         */
+        unassign: async (groupId, conversationId) => {
+          await this.del(
+            `/v1/code/groups/${encodeURIComponent(groupId)}/tasks/${encodeURIComponent(conversationId)}`
+          );
+        }
       }
     };
     if (isApiKeyConfig(config)) {
@@ -1061,7 +1134,11 @@ var AstralformClient = class {
       // A mode this SDK does not know must not reach a `switch` typed as
       // `VoicePolishMode`; `structured` is the server's own default.
       defaultMode: isVoicePolishMode(raw.default_mode) ? raw.default_mode : "structured",
-      silenceAutoStopSeconds: raw.silence_auto_stop_seconds ?? 2,
+      // Deliberately not read from the wire. The field was retired from the
+      // platform (2026-10-09): no shipped client implements pause detection
+      // and the server no longer sends it, so an older server's stored value
+      // must not resurrect it.
+      silenceAutoStopSeconds: 2,
       // Deliberately not read from the wire. Auto-send was removed from the
       // platform (2026-09-14) and the server pins `auto_send` to false; an
       // older server still sending `true` must not make a client auto-send, so
@@ -1718,22 +1795,24 @@ function translateWireEvent(wire) {
         status: wire.status,
         final: wire.final
       };
-    case "message_stop":
+    case "message_stop": {
+      const usage = wire.usage ?? {};
       return {
         type: "message_stop",
         turnId: wire.turn_id,
         jobId: wire.job_id,
         stopReason: wire.stop_reason,
         usage: {
-          inputTokens: wire.usage.input_tokens ?? 0,
-          outputTokens: wire.usage.output_tokens ?? 0,
-          cachedTokens: wire.usage.cached_tokens ?? 0,
-          cacheCreationTokens: wire.usage.cache_creation_tokens ?? 0
+          inputTokens: usage.input_tokens ?? 0,
+          outputTokens: usage.output_tokens ?? 0,
+          cachedTokens: usage.cached_tokens ?? 0,
+          cacheCreationTokens: usage.cache_creation_tokens ?? 0
         },
         ttfbMs: wire.ttfb_ms,
         totalMs: wire.total_ms,
         stallCount: wire.stall_count
       };
+    }
     case "stall":
       return {
         type: "stall",
@@ -2085,7 +2164,7 @@ var ChatSession = class {
       if (!(err instanceof DOMException && err.name === "AbortError")) {
         this.emit({
           type: "error",
-          code: "connection_error",
+          code: err instanceof AstralformError ? err.code : "connection_error",
           message: err instanceof Error ? err.message : String(err),
           blockPath: null
         });
@@ -2237,6 +2316,9 @@ var ChatSession = class {
             if (typeof data?.seq === "number") {
               this.lastSeq = data.seq;
             }
+            if (typeof data === "object" && data !== null && "data" in data && data.data === "[DONE]") {
+              sawTerminal = true;
+            }
             continue;
           }
           parsed = data;
@@ -2366,7 +2448,7 @@ var ChatSession = class {
         }
         return;
       case "block_delta":
-        if (ownsTurnState && wire.delta.channel === "text" && this.currentTextPath !== null && pathEquals(this.currentTextPath, wire.path)) {
+        if (ownsTurnState && wire.delta?.channel === "text" && this.currentTextPath !== null && pathEquals(this.currentTextPath, wire.path)) {
           this.accumulatedText += wire.delta.text;
         }
         return;