@base44-preview/sdk 0.8.48-pr.286.7d59d14 → 0.8.48-pr.286.d14ea24

package/dist/platform/client/index.d.ts

@@ -4,4 +4,4 @@ export { PlatformSocketError } from "./errors.js";
 export type { PlatformSocketErrorCode } from "./errors.types.js";
 export type { PlatformClientOptions } from "./client.types.js";
 export type { BuilderModule, BuilderInitOptions, BuilderSession, PlatformSubscription, SubscriptionOptions } from "./modules/builder.types.js";
-export type { AppUpdate, ChatMessage, ToolCall, QueueItem, QueueUpdate, TaskUpdate, ImageReady, Directive, PlatformEventMap, PlatformEvent, Joined } from "./modules/builder.events.types.js";
+export type { AppUpdate, ChatMessage, ToolCall, ToolDisplayProjection, ToolQuestionOption, ToolQuestion, ToolQuestionArguments, ToolSecretField, ToolSecretArguments, ToolPackageOperation, ToolPackageArguments, ToolPlanUpdate, ToolPlanArguments, ToolMediaArguments, ToolQuestionAnswer, ToolQuestionInput, ToolOutcome, QueueItem, QueueUpdate, TaskUpdate, ImageReady, Directive, PlatformEventMap, PlatformEvent, Joined } from "./modules/builder.events.types.js";

package/dist/platform/client/modules/builder.events.types.d.ts

@@ -1,4 +1,109 @@
-/** Public progress of an existing builder tool; arguments and results are withheld. */
+/** A reviewed file, execution, or entity activity summary. */
+export interface ToolDisplayProjection {
+    /** Changed file paths for a file operation. Source bodies and diffs are never included. */
+    file_paths?: string[];
+    /** Whether a file write intentionally used empty content. */
+    content_empty?: boolean;
+    /** Reviewed execution activity summary. Commands and execution output are never included. */
+    summary?: string;
+    /** Whether a reviewed execution action changed entity data. */
+    writes_entities?: boolean;
+    /** Entity type affected by an entity operation. Records and query values are never included. */
+    entity_name?: string;
+    /** Number of records affected when supplied by the producer. */
+    record_count?: number;
+}
+/** A reviewed selectable answer to a builder question. */
+export interface ToolQuestionOption {
+    /** Visible option label. */
+    label: string;
+}
+/** A reviewed builder question. Image/HTML source and private design context are excluded. */
+export interface ToolQuestion {
+    /** Visible question text. */
+    question?: string;
+    /** Existing question category. */
+    type?: string;
+    /** Optional visible supporting text. */
+    description?: string;
+    /** Whether more than one answer may be selected. */
+    multi_select?: boolean;
+    /** Optional existing plan section identifier. */
+    covers?: string;
+    /** Reviewed selectable options. */
+    options?: ToolQuestionOption[];
+}
+/** Reviewed question arguments, serialized in `ToolCall.arguments_string`. */
+export interface ToolQuestionArguments {
+    /** Questions presented by a clarifying-question tool. */
+    questions: ToolQuestion[];
+}
+/** A requested secret field. The secret value is never sent over the socket. */
+export interface ToolSecretField {
+    /** Requested secret name. */
+    secretName: string;
+    /** Optional explanation of where to obtain it. */
+    description?: string;
+}
+/** Reviewed secret-form arguments, serialized in `ToolCall.arguments_string`. */
+export interface ToolSecretArguments {
+    /** Requested secret fields. */
+    secrets_schema: ToolSecretField[];
+}
+/** A reviewed package operation. Versions and package-manager output are excluded. */
+export interface ToolPackageOperation {
+    /** Package name. */
+    name: string;
+    /** Requested package operation. */
+    action?: string;
+}
+/** Reviewed package arguments, serialized in `ToolCall.arguments_string`. */
+export interface ToolPackageArguments {
+    /** Requested package operations. */
+    packages: ToolPackageOperation[];
+}
+/** A reviewed add-only builder plan update. */
+export interface ToolPlanUpdate {
+    /** Existing update action. */
+    action?: string;
+    /** Plan section key. */
+    section?: string;
+    /** Optional user-facing section label. */
+    section_label?: string;
+    /** Reviewed plan point. */
+    text?: string;
+}
+/** Reviewed plan arguments, serialized in `ToolCall.arguments_string`. */
+export interface ToolPlanArguments {
+    /** Plan updates in their emitted order. */
+    updates?: ToolPlanUpdate[];
+    /** Base plan sections the builder considers sufficiently specified. */
+    sections_with_enough?: string[];
+}
+/** Reviewed generated-media arguments, serialized in `ToolCall.arguments_string`. */
+export interface ToolMediaArguments {
+    /** Visible media label. */
+    label?: string;
+    /** Requested image or video aspect ratio. */
+    aspect_ratio?: string;
+}
+/** A reviewed answer to a clarifying question. Secret-form input is never included. */
+export interface ToolQuestionAnswer {
+    /** Zero-based question index. */
+    question_index?: number;
+    /** Labels selected by the user. */
+    selected_labels?: string[];
+    /** User-provided free-text answer. Structural filtering does not redact prose. */
+    custom_text?: string;
+}
+/** Reviewed clarifying-question input. */
+export interface ToolQuestionInput {
+    /** Answers supplied to the question card. */
+    answers: ToolQuestionAnswer[];
+}
+/** Fixed reviewed completion text. Raw tool results and errors are never included. */
+export type ToolOutcome = "Secret configuration completed." | "Package installation completed." | "Plan updated.";
+/** Public progress of an existing builder tool. */
 export interface ToolCall {
     /** Stable tool call identifier, when included in the update. */
     id?: string;
@@ -8,11 +113,27 @@ export interface ToolCall {
     status?: "running" | "success" | "error" | "stopped" | "waiting_for_user_input";
     /** Whether the tool needs a user response through the partner backend. */
     requires_user_input?: boolean;
+    /** Whether the builder auto-approved the reviewed operation. */
+    auto_approved?: boolean | null;
+    /** Whether the reviewed mutation was applied. */
+    mutation_applied?: boolean | null;
     /** Existing serialized interaction category; no raw interaction payload. */
     waiting_on?: {
         /** Kind of response expected. */
         kind?: "approval" | "choice" | "input" | null;
-    };
+    } | null;
+    /**
+     * JSON containing one reviewed argument shape: ToolQuestionArguments,
+     * ToolSecretArguments, ToolPackageArguments, ToolPlanArguments, or ToolMediaArguments.
+     * It is omitted for all other tools and malformed/partial streaming arguments.
+     */
+    arguments_string?: string;
+    /** Reviewed activity metadata for file, execution, or entity tools. */
+    display_projection?: ToolDisplayProjection;
+    /** Reviewed clarifying-question answers only. */
+    user_input?: ToolQuestionInput;
+    /** Fixed reviewed success outcome only. */
+    results?: ToolOutcome;
 }
 /** Public message replacement. Omitted properties are not synthesized by the SDK. */
 export interface ChatMessage {
@@ -24,7 +145,7 @@ export interface ChatMessage {
     content?: string | null;
     /** Attached file URLs. */
     file_urls?: string[] | null;
-    /** Public tool progress, without arguments or results. */
+    /** Public tool progress with optional reviewed interaction details. */
     tool_calls?: ToolCall[] | null;
     /** Message timestamp, without author identity. */
     metadata?: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base44-preview/sdk",
-  "version": "0.8.48-pr.286.7d59d14",
+  "version": "0.8.48-pr.286.d14ea24",
   "description": "JavaScript SDK for Base44 API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",