@lovable.dev/sdk 0.1.8 → 0.1.10

package/README.md

@@ -31,7 +31,7 @@ const project = await client.createProject(workspaces[0].id, {
 // 2. Wait for the AI response and get the preview URL
 const response = await client.waitForResponse(project.id);
 console.log(response.content);    // AI's response text
-console.log(response.messageId);  // AI message ID (for traces)
+console.log(response.messageId);  // AI message ID
 console.log(response.previewUrl); // Preview URL for the project
 
 // 3. Send a follow-up chat message
@@ -89,66 +89,6 @@ The `continuation` option on `chat()` overrides prompt cache reuse behavior. API
 | `"fresh_build"` | Force full prompt rebuild |
 | `"allow_expired_cache"` | Skip expiry check only |
 
-### Using a custom model
-
-You can route the main agent to a custom OpenAI-compatible endpoint (for example your own inference base URL):
-
-```typescript
-await client.chat(project.id, {
-  message: "Add a dark mode toggle",
-  customModel: {
-    endpoint: "https://my-vllm.example.com/v1",
-    apiKey: "sk-...",
-    modelName: "my-org/my-model-id",
-  },
-});
-```
-
-Optional `customModelDisableRace` on `chat()` (JSON field `custom_model_disable_race`) skips staggered inference racing when the server supports it for your endpoint. Requires API-key authentication, same as other custom-model fields.
-
-### Fetching message traces (`_dev`)
-
-Trace APIs are available under the `_dev` namespace. These are not part of the stable v1 surface and may change without notice.
-
-```typescript
-const response = await client.waitForResponse(project.id);
-
-// Fetch all traces for the message
-const traces = await client._dev.getMessageTraces(project.id, response.messageId);
-console.log(traces.spans);
-
-// Filter by purpose (e.g. only the main agent span)
-const agentTraces = await client._dev.getMessageTraces(project.id, response.messageId, {
-  purposes: ["main_agent"],
-});
-
-// Batch fetch traces for multiple messages
-const result = await client._dev.getMessageTracesBatch([
-  { projectId: "proj-1", messageId: "msg-1" },
-  { projectId: "proj-2", messageId: "msg-2" },
-], { purposes: ["main_agent"], concurrency: 5 });
-
-for (const [messageId, trace] of result.traces) {
-  console.log(messageId, trace.spans.length);
-}
-for (const [messageId, error] of result.errors) {
-  console.error(messageId, error.message);
-}
-```
-
-### Replaying reviewers (`_dev`)
-
-Re-run quality reviewers (e.g. `project_success_v3`, `user_sentiment`) for past assistant messages. Requires an API key with project write access; not part of the stable v1 OpenAPI bundle (types live in this SDK).
-
-```typescript
-const out = await client._dev.replayReviews(project.id, {
-  items: [{ response_message_id: "aimsg_..." }],
-  reviewer_types: ["project_success_v3", "user_sentiment"],
-  concurrency: 4,
-});
-console.log(out.results.items);
-```
-
 ## API Reference
 
 ### `LovableClient`
@@ -203,9 +143,7 @@ Options:
 - `message` (required): The message to send
 - `files` (optional): Array of files to attach (browser `File` objects or `FileInput` objects)
 - `chatOnly` (optional): If true, only chat without making code changes
-- `customModel` (optional): Route the main agent to a custom OpenAI-compatible endpoint (see `CustomModelConfig`)
-- `customModelDisableRace` (optional): Skip staggered inference racing for allowlisted custom model hosts (JSON `custom_model_disable_race`). API-key auth only; see [Using a custom model](#using-a-custom-model)
-- `continuation` (optional): Override prompt cache continuation behavior (`"force"` | `"fresh_build"` | `"allow_expired_cache"`). API-key auth only. See [Controlling prompt cache continuation](#controlling-prompt-cache-continuation)
+- `continuation` (optional): Override prompt cache continuation behavior (`"force"` | `"fresh_build"` | `"allow_expired_cache"`). API-key auth only. See [Continuation override](#continuation-override)
 
 Note: This is an asynchronous operation. The API accepts the message and processes it in the background. Use `waitForResponse()` to wait for the AI's reply.
 
@@ -218,7 +156,7 @@ Use this after `chat()` or after `createProject()` with `initialMessage`.
 Returns:
 
 - `content` (string): The AI's full response text
-- `messageId` (string): The AI message ID (use with `_dev.getMessageTraces()`)
+- `messageId` (string): The AI message ID
 - `previewUrl` (string): The project's preview URL
 
 Options:
@@ -308,48 +246,6 @@ Options:
 
 Throws an error if the remix fails or timeout is reached.
 
-#### `_dev` (developer/experimental APIs)
-
-These methods are not part of the stable v1 surface and may change without notice.
-
-##### `_dev.getMessageTraces(projectId: string, messageId: string, options?): Promise<MessageTracesResponse>`
-
-Fetch Braintrust trace spans for a specific chat message. The `messageId` is available from the `ChatResponse` returned by `waitForResponse()`.
-
-When a purpose has multiple spans (e.g. `main_agent` across turns), only the last span is returned — it contains the full accumulated context.
-
-Options:
-
-- `purposes` (optional): Filter spans by purpose (e.g. `["main_agent", "knowledge_rag"]`)
-
-Returns:
-
-- `message_id` (string): The message ID
-- `braintrust_span_id` (string): The Braintrust span ID
-- `root_span_id` (string): The root span ID
-- `spans` (TraceSpan[]): The filtered trace spans
-
-##### `_dev.getMessageTracesBatch(queries, options?): Promise<BatchTracesResult>`
-
-Fetch traces for multiple messages across projects in parallel.
-
-- `queries`: Array of `{ projectId, messageId }` to fetch
-- `options.purposes` (optional): Filter spans by purpose (applied to all queries)
-- `options.concurrency` (optional): Max parallel requests (default: 5)
-
-Returns:
-
-- `traces`: Map of messageId → `MessageTracesResponse`
-- `errors`: Map of messageId → `Error` (for failed requests)
-
-##### `_dev.replayReviews(projectId: string, body): Promise<ReplayReviewsResponse>`
-
-Re-run reviewers for one or more assistant (`response`) messages. Requires an API key with project write access.
-
-- `body.items`: Each entry must include `response_message_id` (assistant message id). Optional per-item `reviewer_types`.
-- `body.reviewer_types` (optional): Global default when an item omits `reviewer_types`.
-- `body.concurrency` (optional): Parallel items (default 4, max 16).
-
 ##### `inviteCollaborator(workspaceId: string, options): Promise<WorkspaceMembershipResponse>`
 
 Invite a user to a workspace.
@@ -382,12 +278,8 @@ import type {
   CreateProjectOptions,
   ChatResponse,
   ContinuationOverride,
-  CustomModelConfig,
   FileInput,
   RemixProjectOptions,
-  TracePurpose,
-  TraceSpan,
-  MessageTracesResponse,
   // ... etc
 } from "@lovable.dev/sdk";
 ```
@@ -404,18 +296,6 @@ interface FileInput {
 }
 ```
 
-### `CustomModelConfig`
-
-Configuration for routing the main agent to a custom OpenAI-compatible endpoint:
-
-```typescript
-interface CustomModelConfig {
-  endpoint: string;   // Base URL (e.g., "https://my-vllm.example.com/v1")
-  apiKey: string;     // API key for the endpoint
-  modelName: string;  // Model identifier (e.g., "my-org/my-model-id")
-}
-```
-
 ### `ContinuationOverride`
 
 Controls prompt cache continuation behavior for a message:
@@ -427,11 +307,3 @@ type ContinuationOverride = "force" | "fresh_build" | "allow_expired_cache";
 - `"force"` — skip all continuation checks (force continuation)
 - `"fresh_build"` — force a full prompt rebuild from scratch
 - `"allow_expired_cache"` — skip cache expiry check but respect other continuation checks
-
-### `TracePurpose`
-
-Available trace span purposes:
-
-```typescript
-type TracePurpose = "main_agent" | "codebase_rag" | "knowledge_rag" | "review";
-```