Troubleshooting

[@firstflow/sdk] LLM call tagged with some but not all of `firstflowAgentId`, `sessionId`, `userId` the call was NOT observed. Provide all three to track it.

import { OpenAI } from "@firstflow/sdk/openai";

// FIRSTFLOW_API_KEY is read from the environment never hard-code it.
const client = new OpenAI();

const res = await client.chat.completions.create({
  firstflowAgentId: "agt_123",        // primary routing key
  sessionId: "ses_abc",               // groups messages into one conversation
  userId: "user_42",                  // the end-user, stable across sessions
  model: "gpt-4o",
  messages: [{ role: "user", content: "How do I export my data?" }],
});

// Browser pass it as conversationId
<FirstflowProvider
  agentId="agt_123"
  publishableKey="pk_live_…"
  user={{ id: "user_42" }}
  conversationId={conversationId}   // e.g. "ses_abc"
>
  {children}
</FirstflowProvider>

// Server pass the identical value as sessionId
await client.chat.completions.create({
  firstflowAgentId: "agt_123",
  sessionId: conversationId,        // SAME string as the browser conversationId
  userId: "user_42",
  model: "gpt-4o",
  messages,
});

// Browser traits travel with identity
<FirstflowProvider
  agentId="agt_123"
  publishableKey="pk_live_…"
  user={{ id: "user_42", email: "ada@example.com", traits: { plan: "pro" } }}
>
  {children}
</FirstflowProvider>

// Server attach or update traits out of band
import { identify } from "@firstflow/sdk";

identify({ firstflowAgentId: "agt_123", userId: "user_42", traits: { plan: "pro" } });