@astralform/js 2.0.0 → 3.0.1

package/dist/index.d.cts

@@ -138,7 +138,7 @@ interface AstralformUserTokenConfig extends AstralformBaseConfig {
      */
     accessToken: string;
     /**
-     * Active agent context. Sent as the `X-Project-ID` header (legacy wire name). The backend
+     * Active agent context. Sent as the `X-Agent-ID` header. The backend
      * verifies the token's developer has access to this agent on every
      * request; switching agents is a local `updateAgentId()` call.
      *
@@ -151,7 +151,7 @@ interface AstralformUserTokenConfig extends AstralformBaseConfig {
     /**
      * Optional end-user override — lets a developer acting under a user
      * token impersonate a downstream end-user identity for testing
-     * purposes. When set, sent alongside `X-Project-ID` as `X-End-User-ID`
+     * purposes. When set, sent alongside `X-Agent-ID` as `X-End-User-ID`
      * so memory, rate limits, and conversations scope to the specified
      * end-user rather than the developer themselves.
      *
@@ -988,10 +988,11 @@ declare class ChatSession {
     switchConversation(id: string, jobId?: string, 
     /**
      * User prompt that triggered this job, if known. Emitted as a
-     * synthetic ``user_message`` ChatEvent right before the first
-     * ``message_start`` of the replay. User messages aren't persisted
-     * in ``job_events``, so without this the restored conversation
-     * would show the agent response with no visible prompt above it.
+     * synthetic ``user_message`` ChatEvent at the START of the replay —
+     * a completed job maps to exactly one user turn, so every event in it
+     * belongs beneath that prompt. User messages aren't persisted in
+     * ``job_events``, so without this the restored conversation would show
+     * the agent response with no visible prompt above it.
      */
     userMessageContent?: string): Promise<void>;
     deleteConversation(id: string): Promise<void>;
@@ -1145,8 +1146,18 @@ interface RawSseEvent {
 declare function mapSseToChat(raw: RawSseEvent): ChatEvent[];
 /**
  * Replay persisted SSE events through the provided handler, interleaving
- * user messages from session.messages at the first message_start of each
- * turn (user messages aren't persisted in job_events).
+ * user messages from session.messages at the START of each turn (user
+ * messages aren't persisted in job_events).
+ *
+ * The turn boundary is a change of ``job_id``, NOT ``message_start`` or
+ * ``message_stop``. A completed job maps to exactly one user turn — but a
+ * single job can contain several ``message_start``/``message_stop`` pairs (a
+ * tool-use loop: LLM call → tool result → LLM call again), so neither event
+ * reliably delimits turns. And within a job some events precede the first
+ * ``message_start`` (e.g. ``memory_recall``, emitted during prompt prep), so
+ * gating the user block on ``message_start`` would replay them above the
+ * user's own message. Keying off ``job_id`` injects the prompt once per job,
+ * before its first event — matching ``session.ts#switchConversation``.
  */
 declare function replayEvents(sseEvents: RawSseEvent[], userMessages: {
     role: string;

package/dist/index.d.ts

@@ -138,7 +138,7 @@ interface AstralformUserTokenConfig extends AstralformBaseConfig {
      */
     accessToken: string;
     /**
-     * Active agent context. Sent as the `X-Project-ID` header (legacy wire name). The backend
+     * Active agent context. Sent as the `X-Agent-ID` header. The backend
      * verifies the token's developer has access to this agent on every
      * request; switching agents is a local `updateAgentId()` call.
      *
@@ -151,7 +151,7 @@ interface AstralformUserTokenConfig extends AstralformBaseConfig {
     /**
      * Optional end-user override — lets a developer acting under a user
      * token impersonate a downstream end-user identity for testing
-     * purposes. When set, sent alongside `X-Project-ID` as `X-End-User-ID`
+     * purposes. When set, sent alongside `X-Agent-ID` as `X-End-User-ID`
      * so memory, rate limits, and conversations scope to the specified
      * end-user rather than the developer themselves.
      *
@@ -988,10 +988,11 @@ declare class ChatSession {
     switchConversation(id: string, jobId?: string, 
     /**
      * User prompt that triggered this job, if known. Emitted as a
-     * synthetic ``user_message`` ChatEvent right before the first
-     * ``message_start`` of the replay. User messages aren't persisted
-     * in ``job_events``, so without this the restored conversation
-     * would show the agent response with no visible prompt above it.
+     * synthetic ``user_message`` ChatEvent at the START of the replay —
+     * a completed job maps to exactly one user turn, so every event in it
+     * belongs beneath that prompt. User messages aren't persisted in
+     * ``job_events``, so without this the restored conversation would show
+     * the agent response with no visible prompt above it.
      */
     userMessageContent?: string): Promise<void>;
     deleteConversation(id: string): Promise<void>;
@@ -1145,8 +1146,18 @@ interface RawSseEvent {
 declare function mapSseToChat(raw: RawSseEvent): ChatEvent[];
 /**
  * Replay persisted SSE events through the provided handler, interleaving
- * user messages from session.messages at the first message_start of each
- * turn (user messages aren't persisted in job_events).
+ * user messages from session.messages at the START of each turn (user
+ * messages aren't persisted in job_events).
+ *
+ * The turn boundary is a change of ``job_id``, NOT ``message_start`` or
+ * ``message_stop``. A completed job maps to exactly one user turn — but a
+ * single job can contain several ``message_start``/``message_stop`` pairs (a
+ * tool-use loop: LLM call → tool result → LLM call again), so neither event
+ * reliably delimits turns. And within a job some events precede the first
+ * ``message_start`` (e.g. ``memory_recall``, emitted during prompt prep), so
+ * gating the user block on ``message_start`` would replay them above the
+ * user's own message. Keying off ``job_id`` injects the prompt once per job,
+ * before its first event — matching ``session.ts#switchConversation``.
  */
 declare function replayEvents(sseEvents: RawSseEvent[], userMessages: {
     role: string;

package/dist/index.js

@@ -379,7 +379,7 @@ var AstralformClient = class {
       Authorization: `Bearer ${this.auth.accessToken}`
     };
     if (this.auth.agentId) {
-      headers["X-Project-ID"] = this.auth.agentId;
+      headers["X-Agent-ID"] = this.auth.agentId;
     }
     if (this.auth.endUserId) {
       headers["X-End-User-ID"] = this.auth.endUserId;
@@ -434,10 +434,9 @@ var AstralformClient = class {
   async getHealth() {
     return this.get("/v1/health");
   }
-  // Agent readiness check. The path is a legacy wire name (shared with the
-  // iOS SDK) — it scopes to the client's active agent via X-Project-ID.
+  // Agent readiness check, scoped to the client's active agent via X-Agent-ID.
   async getAgentStatus() {
-    const raw = await this.get("/v1/project/status");
+    const raw = await this.get("/v1/agent/status");
     const ui = raw.ui_components ?? {};
     return {
       isReady: raw.is_ready,
@@ -607,7 +606,7 @@ var AstralformClient = class {
   // --- Account-scoped discovery (user-token mode) ---
   //
   // Lets a signed-in user pick which team/agent they want to act on.
-  // Backend gates these on OIDC user context (no X-Project-ID required) —
+  // Backend gates these on OIDC user context (no X-Agent-ID required) —
   // sending them in API-key mode yields 401.
   async listTeams() {
     const raw = await this.get("/v1/teams");
@@ -1629,17 +1628,12 @@ var ChatSession = class {
     ]);
     this.messages = messagesResult.status === "fulfilled" ? messagesResult.value : [];
     if (eventsResult.status === "fulfilled") {
-      let userMessageEmitted = !userMessageContent;
+      if (userMessageContent) {
+        this.emit({ type: "user_message", content: userMessageContent });
+      }
       for (const ev of eventsResult.value) {
         const type = ev.data.type || ev.event;
         if (!type || type === "done") continue;
-        if (!userMessageEmitted && type === "message_start") {
-          this.emit({
-            type: "user_message",
-            content: userMessageContent
-          });
-          userMessageEmitted = true;
-        }
         const wire = { ...ev.data, type };
         try {
           await this.dispatchWireEvent(
@@ -1948,21 +1942,21 @@ function mapSseToChat(raw) {
 function replayEvents(sseEvents, userMessages, handleEvent, addBlock) {
   const userMsgs = userMessages.filter((m) => m.role === "user");
   let userIdx = 0;
-  let expectingUserMessage = true;
+  let currentJobId = null;
   for (const raw of sseEvents) {
     const type = raw.data.type || raw.event;
-    if (type === "message_stop") {
-      expectingUserMessage = true;
-    }
-    if (type === "message_start" && expectingUserMessage && userIdx < userMsgs.length) {
-      const userMsg = userMsgs[userIdx];
-      addBlock({
-        type: "user",
-        id: `replay_user_${userIdx}`,
-        content: userMsg.content
-      });
-      userIdx++;
-      expectingUserMessage = false;
+    if (!type || type === "done") continue;
+    const jobId = raw.data.job_id ?? null;
+    if (jobId !== null && jobId !== currentJobId) {
+      currentJobId = jobId;
+      if (userIdx < userMsgs.length) {
+        addBlock({
+          type: "user",
+          id: `replay_user_${userIdx}`,
+          content: userMsgs[userIdx].content
+        });
+        userIdx++;
+      }
     }
     for (const ce of mapSseToChat(raw)) {
       handleEvent(ce);