lemma-sdk 0.2.43 → 0.2.45

package/README.md

@@ -188,8 +188,6 @@ function AgentButton({ client }: { client: LemmaClient }) {
           const thread = await conversation.createConversation({
             title: "Triage ticket ticket_123",
             instructions: "Triage the ticket, propose the next owner, and explain the confidence level.",
-            metadata: { source: "support_queue", ticket_id: "ticket_123" },
-            type: "TASK",
             setActive: true,
           });
           await conversation.sendMessage(JSON.stringify({
@@ -444,7 +442,7 @@ Useful helpers:
 - `setTestingToken(...)`
 - `clearTestingToken()`
 
-When `client.podId` is set and the signed-in user is not a pod member, `AuthGuard` checks membership through the pod-member lookup endpoint and renders an interactive request-access flow. Pass `appName` to label the default auth screens with your app's name. It can create a pod join request, show a pending request, retry access checks, and then render the app once the user is a member.
+When `client.podId` is set and the signed-in user is not a pod member, `AuthGuard` can render the request-access flow and create or show pod join requests.
 
 `usePodAccess` exposes the same membership/request-access state as a hook for custom UI.
 
@@ -463,8 +461,7 @@ From `0.2.37` onward:
 
 - Agent APIs are the runtime abstraction. `client.assistants` is removed; use `client.agents` for definitions and `client.conversations` for turns/messages.
 - Conversations are pod-scoped under the agent conversation API; message sends stream conversation events until final output.
-- Conversation creation accepts `instructions`, `metadata`, and `type`; message sends accept `metadata`. Use conversation instructions for durable agent context and message metadata for per-turn provenance, object IDs, and UI recovery data.
-- File API namespace query/body fields are no longer in the live OpenAPI. The SDK still accepts `namespace` in file helpers for source compatibility, but it is currently a no-op on requests.
+- Files are a path-based tree, not a namespace enum. `/me` is each user's private per-user tree (only the owner sees their `/me` files); every other path is pod-shared, and folder grants cascade to all descendants. Scope reads and uploads by `directoryPath`/`path` rather than a namespace. Files are auto-indexed searchable documents (built-in RAG), and file search supports directory-scoped queries via `scope_path` + `scope_mode` (`SUBTREE` for a folder and its descendants, `DIRECT` for immediate children).
 
 From `0.2.39` onward:
 

package/dist/assistant-events.d.ts

@@ -3,6 +3,8 @@ export interface ParsedAssistantStreamEvent {
     message?: ConversationMessage;
     status?: string;
     token?: string;
+    tokenKind?: string;
+    error?: string;
 }
 export declare function parseAssistantStreamEvent(value: unknown): ParsedAssistantStreamEvent;
 export declare function upsertConversationMessage(messages: ConversationMessage[], incoming: ConversationMessage): ConversationMessage[];

package/dist/assistant-events.js

@@ -1,11 +1,26 @@
+const CONVERSATION_STATUS_ALIASES = {
+    RUNNING: "RUNNING",
+    IN_PROGRESS: "IN_PROGRESS",
+    PROCESSING: "PROCESSING",
+    STOP_REQUESTED: "STOP_REQUESTED",
+    WAITING: "WAITING",
+    COMPLETED: "COMPLETED",
+    COMPLETE: "COMPLETED",
+    DONE: "COMPLETED",
+    FAILED: "FAILED",
+    ERROR: "FAILED",
+    STOPPED: "STOPPED",
+    CANCELLED: "STOPPED",
+    CANCELED: "STOPPED",
+};
 function isRecord(value) {
     return !!value && typeof value === "object" && !Array.isArray(value);
 }
 function normalizeStatus(status) {
     if (typeof status !== "string")
         return undefined;
-    const normalized = status.trim().toUpperCase();
-    return normalized.length > 0 ? normalized : undefined;
+    const normalized = status.trim().toUpperCase().replace(/[-\s]+/g, "_");
+    return CONVERSATION_STATUS_ALIASES[normalized];
 }
 function toConversationMessage(value) {
     if (!isRecord(value))
@@ -41,6 +56,25 @@ function extractStatus(payload) {
     }
     return normalizeStatus(payload);
 }
+function extractErrorMessage(payload) {
+    if (typeof payload === "string") {
+        const message = payload.trim();
+        return message.length > 0 ? message : undefined;
+    }
+    if (isRecord(payload)) {
+        const message = [
+            payload.message,
+            payload.error,
+            payload.detail,
+            payload.reason,
+            payload.description,
+        ].find((value) => typeof value === "string" && value.trim().length > 0);
+        if (typeof message === "string") {
+            return message.trim();
+        }
+    }
+    return undefined;
+}
 export function parseAssistantStreamEvent(value) {
     const directMessage = toConversationMessage(value);
     if (directMessage) {
@@ -52,7 +86,10 @@ export function parseAssistantStreamEvent(value) {
     const eventType = typeof value.type === "string" ? value.type.toLowerCase() : "";
     const payload = extractPayload(value);
     if (eventType === "token" && typeof payload === "string") {
-        return { token: payload };
+        const tokenKind = typeof value.kind === "string" && value.kind.trim()
+            ? value.kind.trim().toLowerCase()
+            : "text";
+        return { token: payload, tokenKind };
     }
     if (eventType === "message" || eventType === "message_added") {
         const message = toConversationMessage(payload);
@@ -65,6 +102,16 @@ export function parseAssistantStreamEvent(value) {
         const status = extractStatus(payload);
         return status ? { status } : {};
     }
+    if (eventType === "completed") {
+        const status = extractStatus(payload) ?? "COMPLETED";
+        return { status };
+    }
+    if (eventType === "error" || eventType === "stream_error") {
+        return {
+            status: "FAILED",
+            error: extractErrorMessage(payload) ?? "Agent run failed.",
+        };
+    }
     return {};
 }
 export function upsertConversationMessage(messages, incoming) {