lemma-sdk 0.2.44 → 0.2.46

package/README.md

@@ -461,7 +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.
-- File APIs are namespace-aware. Shared pod files are the default for backwards-compatible file workspaces; pass `namespace: "PRIVATE"` for personal file input/upload flows and `namespace: "POD"` when you want to be explicit. The live OpenAPI currently names the private namespace `PERSONAL`; the SDK accepts `PRIVATE` as the product-facing alias.
+- 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

@@ -4,6 +4,7 @@ export interface ParsedAssistantStreamEvent {
     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

@@ -29,13 +29,23 @@ function toConversationMessage(value) {
         return undefined;
     if (typeof value.role !== "string")
         return undefined;
-    if (!("content" in value))
+    // Flat shape: every persisted message carries a `kind` discriminator. The old
+    // nested `content` object is gone.
+    if (typeof value.kind !== "string")
         return undefined;
     const message = {
         id: value.id,
         role: value.role,
-        content: value.content,
+        kind: value.kind,
+        text: typeof value.text === "string" ? value.text : null,
+        tool_name: typeof value.tool_name === "string" ? value.tool_name : null,
+        tool_call_id: typeof value.tool_call_id === "string" ? value.tool_call_id : null,
+        tool_args: "tool_args" in value ? value.tool_args : null,
+        tool_result: "tool_result" in value ? value.tool_result : null,
         created_at: typeof value.created_at === "string" ? value.created_at : new Date().toISOString(),
+        conversation_id: typeof value.conversation_id === "string" ? value.conversation_id : undefined,
+        sequence: typeof value.sequence === "number" ? value.sequence : undefined,
+        agent_run_id: typeof value.agent_run_id === "string" ? value.agent_run_id : null,
         metadata: isRecord(value.metadata) ? value.metadata : null,
     };
     return message;
@@ -56,6 +66,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) {
@@ -87,6 +116,12 @@ export function parseAssistantStreamEvent(value) {
         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) {