@astralform/js 7.3.0 → 7.4.1

package/dist/index.cjs

@@ -389,6 +389,69 @@ function isApiKeyConfig(config) {
 }
 var AstralformClient = class {
   constructor(config) {
+    // --- Code mode: the app user's projects ---
+    /**
+     * 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.
+     */
+    this.code = {
+      projects: {
+        /** This user's projects on the active agent, oldest first. */
+        list: async () => {
+          const raw = await this.get(
+            "/v1/code/projects"
+          );
+          return raw.map((p) => camelizeKeys(p));
+        },
+        /**
+         * What the workspace's GitHub installations cover, minus what this user
+         * has already added. Read `state` before the list: an empty `repositories`
+         * means something different in each of its three values.
+         */
+        available: async () => {
+          const raw = await this.get("/v1/code/projects/available");
+          return {
+            state: raw.state,
+            repositories: (raw.repositories ?? []).map((r) => ({
+              fullName: r.full_name,
+              private: r.private
+            })),
+            // Defaulted like its neighbours: the `unavailable` branch has nothing
+            // to count, and an absent field behind a `number` type prints
+            // "undefined" in a picker rather than a number.
+            totalCount: raw.total_count ?? 0,
+            partial: raw.partial ?? false
+          };
+        },
+        /**
+         * Add a repository. The server checks it against the workspace's own
+         * installations and answers a repository it cannot reach the same way it
+         * answers one owned by someone else — deliberately, so this call cannot be
+         * used to discover which organisations use Astralform.
+         */
+        add: async (repoFullName) => {
+          const raw = await this.post(
+            "/v1/code/projects",
+            { repo_full_name: repoFullName }
+          );
+          return camelizeKeys(raw);
+        },
+        /**
+         * Remove a project. Tasks already bound to that repository keep their
+         * binding — they simply stop grouping under it.
+         */
+        remove: async (owner, repo) => {
+          await this.del(
+            `/v1/code/projects/${encodeURIComponent(owner)}/${encodeURIComponent(repo)}`
+          );
+        }
+      }
+    };
     if (isApiKeyConfig(config)) {
       if (!config.apiKey || typeof config.apiKey !== "string") {
         throw new Error("apiKey is required and must be a non-empty string");
@@ -629,10 +692,18 @@ var AstralformClient = class {
       }
     };
   }
-  async getConversations(limit = 50, offset = 0) {
+  /**
+   * 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.
+   */
+  async getConversations(limit = 50, offset = 0, options) {
     const safeLimit = Math.max(1, Math.min(200, Math.floor(Number(limit))));
     const safeOffset = Math.max(0, Math.floor(Number(offset)));
-    const raw = await this.get(`/v1/conversations?limit=${safeLimit}&offset=${safeOffset}`);
+    const filter = options?.repository ? `&repository=${encodeURIComponent(options.repository)}` : "";
+    const raw = await this.get(`/v1/conversations?limit=${safeLimit}&offset=${safeOffset}${filter}`);
     return raw.map((c) => camelizeKeys(c));
   }
   async getMessages(conversationId) {
@@ -1727,6 +1798,9 @@ 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
+      // server-side: sent on every turn, honoured on the first.
+      repository: options?.repository,
       // Per-request model choice (client-side model selection).
       provider: options?.provider,
       model: options?.model,
@@ -2579,23 +2653,8 @@ var StreamManager = class {
     this.setState("streaming");
     try {
       await this.session.send(content, {
-        // Address the send explicitly. `ChatSession.send` otherwise falls back
-        // to `session.conversationId`, which LAGS this pointer: a restore
-        // assigns it synchronously but only reaches the next switch's own
-        // `loadConversation` an await later, so between the two the session
-        // still names the conversation the user left. The manager's pointer
-        // moved the moment the user clicked; it is the authority.
-        conversationId: target ?? void 0,
-        agentName: options?.agentName,
-        uploadIds: options?.uploadIds,
-        planMode: options?.planMode,
-        imageMode: options?.imageMode,
-        videoMode: options?.videoMode,
-        goal: options?.goal,
-        provider: options?.provider,
-        model: options?.model,
-        reasoningEffort: options?.reasoningEffort,
-        temperature: options?.temperature
+        ...options,
+        conversationId: target ?? void 0
       });
     } catch {
     }