@base44-preview/sdk 0.8.44-pr.265.8da157e → 0.8.44-pr.265.a1a63b2

package/dist/{build-session.d.ts → builder-session.d.ts}

@@ -1,10 +1,10 @@
-import type { BuildSessionReader } from "./modules/build.types.js";
+import type { BuilderSessionReader } from "./modules/builder.types.js";
 import type { CreateClientOptions } from "./client.types.js";
 /**
- * Configuration for reading a build session with a grant.
+ * Configuration for reading a builder session with a grant.
  */
-export interface CreateBuildSessionConfig {
-    /** The app being built. A build session *is* an app — there is nothing separate to open. */
+export interface CreateBuilderSessionConfig {
+    /** The app being built. A builder session *is* an app — there is nothing separate to open. */
     appId: string;
     /**
      * The Base44 server URL.
@@ -15,7 +15,7 @@ export interface CreateBuildSessionConfig {
     /**
      * A grant token.
      *
-     * Use {@link CreateBuildSessionConfig.getToken | getToken} instead for anything
+     * Use {@link CreateBuilderSessionConfig.getToken | getToken} instead for anything
      * that outlives one grant, which most builds do.
      */
     token?: string;
@@ -32,10 +32,10 @@ export interface CreateBuildSessionConfig {
     options?: CreateClientOptions;
 }
 /**
- * Reads one build session with a grant.
+ * Reads one builder session with a grant.
  *
  * The browser's entry point. A grant is read-only, scoped to one session and
- * short-lived, so this returns the read half of a build session and nothing else
+ * short-lived, so this returns the read half of a builder session and nothing else
  * — the writes live on the server, where the credential that can start a turn
  * belongs.
  *
@@ -46,16 +46,16 @@ export interface CreateBuildSessionConfig {
  * browser credential spend your workspace's credits.
  *
  * Mint the grant on your server with
- * {@link BuildSession.createGrant | createGrant()}.
+ * {@link BuilderSession.createGrant | createGrant()}.
  *
  * @param config - The app, and how to get a grant for it.
  * @returns The read-only session.
  *
  * @example
  * ```typescript
- * import { createBuildSession } from '@base44/sdk';
+ * import { createBuilderSession } from '@base44/sdk';
  *
- * const build = createBuildSession({
+ * const builder = createBuilderSession({
  *   appId,
  *   // Re-read on every reconnect, so a build outliving its grant just works.
  *   getToken: () =>
@@ -64,7 +64,7 @@ export interface CreateBuildSessionConfig {
  *       .then((grant) => grant.token),
  * });
  *
- * const unsubscribe = build.subscribe((event) => {
+ * const unsubscribe = builder.subscribe((event) => {
  *   switch (event.type) {
  *     case 'message.updated': upsertMessage(event.data); break;   // by messageId
  *     case 'state.changed':   setStatus(event.data);     break;
@@ -76,4 +76,4 @@ export interface CreateBuildSessionConfig {
  * await fetch('/api/base44/message', { method: 'POST', body: … });
  * ```
  */
-export declare function createBuildSession(config: CreateBuildSessionConfig): BuildSessionReader;
+export declare function createBuilderSession(config: CreateBuilderSessionConfig): BuilderSessionReader;

package/dist/{build-session.js → builder-session.js}

@@ -1,10 +1,10 @@
 import { createAxiosClient } from "./utils/axios-client.js";
-import { createBuildSessionReader } from "./modules/build.js";
+import { createBuilderSessionReader } from "./modules/builder.js";
 /**
- * Reads one build session with a grant.
+ * Reads one builder session with a grant.
  *
  * The browser's entry point. A grant is read-only, scoped to one session and
- * short-lived, so this returns the read half of a build session and nothing else
+ * short-lived, so this returns the read half of a builder session and nothing else
  * — the writes live on the server, where the credential that can start a turn
  * belongs.
  *
@@ -15,16 +15,16 @@ import { createBuildSessionReader } from "./modules/build.js";
  * browser credential spend your workspace's credits.
  *
  * Mint the grant on your server with
- * {@link BuildSession.createGrant | createGrant()}.
+ * {@link BuilderSession.createGrant | createGrant()}.
  *
  * @param config - The app, and how to get a grant for it.
  * @returns The read-only session.
  *
  * @example
  * ```typescript
- * import { createBuildSession } from '@base44/sdk';
+ * import { createBuilderSession } from '@base44/sdk';
  *
- * const build = createBuildSession({
+ * const builder = createBuilderSession({
  *   appId,
  *   // Re-read on every reconnect, so a build outliving its grant just works.
  *   getToken: () =>
@@ -33,7 +33,7 @@ import { createBuildSessionReader } from "./modules/build.js";
  *       .then((grant) => grant.token),
  * });
  *
- * const unsubscribe = build.subscribe((event) => {
+ * const unsubscribe = builder.subscribe((event) => {
  *   switch (event.type) {
  *     case 'message.updated': upsertMessage(event.data); break;   // by messageId
  *     case 'state.changed':   setStatus(event.data);     break;
@@ -45,9 +45,9 @@ import { createBuildSessionReader } from "./modules/build.js";
  * await fetch('/api/base44/message', { method: 'POST', body: … });
  * ```
  */
-export function createBuildSession(config) {
+export function createBuilderSession(config) {
     const { appId, serverUrl = "https://base44.app", token, getToken, options, } = config;
-    return createBuildSessionReader({
+    return createBuilderSessionReader({
         axios: createAxiosClient({
             baseURL: `${serverUrl}/api`,
             onError: options === null || options === void 0 ? void 0 : options.onError,

package/dist/index.d.ts

@@ -1,10 +1,10 @@
 import { createClient, createClientFromRequest, type Base44Client, type CreateClientConfig, type CreateClientOptions } from "./client.js";
 import { createPlatformClient, type CreatePlatformClientConfig, type PlatformClient, type PrincipalClient } from "./platform-client.js";
-import { createBuildSession, type CreateBuildSessionConfig } from "./build-session.js";
+import { createBuilderSession, type CreateBuilderSessionConfig } from "./builder-session.js";
 import { Base44Error, type Base44ErrorJSON } from "./utils/axios-client.js";
 import { getAccessToken, saveAccessToken, removeAccessToken, getLoginUrl } from "./utils/auth-utils.js";
-export { createClient, createClientFromRequest, createPlatformClient, createBuildSession, Base44Error, getAccessToken, saveAccessToken, removeAccessToken, getLoginUrl, };
-export type { Base44Client, CreateClientConfig, CreateClientOptions, Base44ErrorJSON, CreatePlatformClientConfig, PlatformClient, PrincipalClient, CreateBuildSessionConfig, };
+export { createClient, createClientFromRequest, createPlatformClient, createBuilderSession, Base44Error, getAccessToken, saveAccessToken, removeAccessToken, getLoginUrl, };
+export type { Base44Client, CreateClientConfig, CreateClientOptions, Base44ErrorJSON, CreatePlatformClientConfig, PlatformClient, PrincipalClient, CreateBuilderSessionConfig, };
 export * from "./types.js";
 export type { DeleteManyResult, DeleteResult, EntitiesModule, EntityFilterOperators, EntityFilterQuery, EntityFilterValue, EntityHandler, EntityRecord, EntityTypeRegistry, ImportResult, RealtimeEventType, RealtimeEvent, RealtimeCallback, SortField, UpdateManyResult, } from "./modules/entities.types.js";
 export type { AuthModule, LoginResponse, RegisterParams, VerifyOtpParams, ChangePasswordParams, ResetPasswordParams, User, } from "./modules/auth.types.js";
@@ -16,7 +16,7 @@ export type { AppLogsModule } from "./modules/app-logs.types.js";
 export type { ActorsModule, ActorClient, ActorRef, Connection, ActorSubscription, ActorConnectOptions, ActorNameRegistry, ActorRegistry, } from "./modules/actors.types.js";
 export type { SsoModule, SsoAccessTokenResponse } from "./modules/sso.types.js";
 export type { PlatformsModule, PrincipalRole, ProvisionPrincipalParams, ServicePrincipal, DeprovisionResult, } from "./modules/platforms.types.js";
-export type { BuildEvent, BuildEventType, BuildGrant, BuildMessage, BuildMessagePage, BuildResponse, BuildSession, BuildSessionReader, BuildState, BuildStatus, BuildToolCall, BuildTurn, BuildTurnRef, BuildWaitingKind, BuildWaitingOn, CreateBuildGrantOptions, ListBuildMessagesOptions, RespondToBuildOptions, SendBuildMessageOptions, SubscribeToBuildOptions, WaitForTurnOptions, } from "./modules/build.types.js";
+export type { BuilderEvent, BuilderEventType, BuilderGrant, BuilderMessage, BuilderMessagePage, BuilderResponse, BuilderSession, BuilderSessionReader, BuilderState, BuilderStatus, BuilderToolCall, BuilderTurn, BuilderTurnRef, BuilderWaitingKind, BuilderWaitingOn, CreateBuilderGrantOptions, ListBuilderMessagesOptions, RespondToBuilderOptions, SendBuilderMessageOptions, SubscribeToBuilderOptions, WaitForTurnOptions, } from "./modules/builder.types.js";
 export { Actor, type Conn } from "./actor.js";
 export type { ConnectorsModule, UserConnectorsModule, ConnectorApiRequest, ConnectorApiResponse, ConnectorApiResponsePhase, } from "./modules/connectors.types.js";
 export type { CustomIntegrationsModule, CustomIntegrationCallParams, CustomIntegrationCallResponse, } from "./modules/custom-integrations.types.js";

package/dist/index.js

@@ -1,8 +1,8 @@
 import { createClient, createClientFromRequest, } from "./client.js";
 import { createPlatformClient, } from "./platform-client.js";
-import { createBuildSession, } from "./build-session.js";
+import { createBuilderSession, } from "./builder-session.js";
 import { Base44Error } from "./utils/axios-client.js";
 import { getAccessToken, saveAccessToken, removeAccessToken, getLoginUrl, } from "./utils/auth-utils.js";
-export { createClient, createClientFromRequest, createPlatformClient, createBuildSession, Base44Error, getAccessToken, saveAccessToken, removeAccessToken, getLoginUrl, };
+export { createClient, createClientFromRequest, createPlatformClient, createBuilderSession, Base44Error, getAccessToken, saveAccessToken, removeAccessToken, getLoginUrl, };
 export * from "./types.js";
 export { Actor } from "./actor.js";

package/dist/modules/{build.d.ts → builder.d.ts}

@@ -1,10 +1,10 @@
 import type { AxiosInstance } from "axios";
-import type { BuildSession, BuildSessionReader } from "./build.types.js";
+import type { BuilderSession, BuilderSessionReader } from "./builder.types.js";
 /** What the build module needs to talk to one app's session. @internal */
-export interface BuildSessionDeps {
+export interface BuilderSessionDeps {
     /** An Axios client based at `${serverUrl}/api`. */
     axios: AxiosInstance;
-    /** The app whose build session this is. */
+    /** The app whose builder session this is. */
     appId: string;
     /** Used to build the absolute stream URL, which `fetch` needs. */
     serverUrl: string;
@@ -21,18 +21,18 @@ export interface BuildSessionDeps {
     getToken?: () => string | Promise<string> | undefined;
 }
 /**
- * The read half of a build session — what a grant can do.
+ * The read half of a builder session — what a grant can do.
  *
  * @param deps - Transport, app id and credential.
  * @returns The read-only session.
  * @internal
  */
-export declare function createBuildSessionReader(deps: BuildSessionDeps): BuildSessionReader;
+export declare function createBuilderSessionReader(deps: BuilderSessionDeps): BuilderSessionReader;
 /**
- * A build session with the writes, for a credential that may start turns.
+ * A builder session with the writes, for a credential that may start turns.
  *
  * @param deps - Transport, app id and credential.
  * @returns The full session.
  * @internal
  */
-export declare function createBuildSessionModule(deps: BuildSessionDeps): BuildSession;
+export declare function createBuilderSessionModule(deps: BuilderSessionDeps): BuilderSession;

package/dist/modules/{build.js → builder.js}

@@ -79,7 +79,7 @@ function toMessage(raw) {
  *
  * Unrecognised types are dropped here rather than passed through. The contract
  * requires clients to ignore them, so doing it once at the boundary is what lets
- * {@link BuildEvent} stay a closed union that narrows on `type` — the alternative
+ * {@link BuilderEvent} stay a closed union that narrows on `type` — the alternative
  * is an open union whose `data` is `unknown` in every branch.
  */
 function toBuildEvent(data, frameId) {
@@ -120,10 +120,10 @@ async function streamFailure(response) {
     catch (_b) {
         /* a non-JSON error body is still the best message available */
     }
-    return new Base44Error(detail || `Build stream failed with ${response.status}`, response.status, "BUILD_STREAM_FAILED", body, undefined);
+    return new Base44Error(detail || `Build stream failed with ${response.status}`, response.status, "BUILDER_STREAM_FAILED", body, undefined);
 }
 /** Every route in the family hangs off this. */
-const buildPath = (appId) => `/v1/apps/${encodeURIComponent(appId)}/build`;
+const builderPath = (appId) => `/v1/apps/${encodeURIComponent(appId)}/build`;
 /**
  * The credential, resolved per call.
  *
@@ -146,15 +146,15 @@ function delay(ms, signal) {
     });
 }
 /**
- * The read half of a build session — what a grant can do.
+ * The read half of a builder session — what a grant can do.
  *
  * @param deps - Transport, app id and credential.
  * @returns The read-only session.
  * @internal
  */
-export function createBuildSessionReader(deps) {
+export function createBuilderSessionReader(deps) {
     const { axios, appId, getToken } = deps;
-    const path = buildPath(appId);
+    const path = builderPath(appId);
     const eventsUrl = `${deps.serverUrl.replace(/\/+$/, "")}/api${path}/events`;
     const authHeaders = () => bearer(getToken);
     const getState = async () => {
@@ -401,16 +401,16 @@ export function createBuildSessionReader(deps) {
     };
 }
 /**
- * A build session with the writes, for a credential that may start turns.
+ * A builder session with the writes, for a credential that may start turns.
  *
  * @param deps - Transport, app id and credential.
  * @returns The full session.
  * @internal
  */
-export function createBuildSessionModule(deps) {
+export function createBuilderSessionModule(deps) {
     const { axios, appId, getToken, serverUrl } = deps;
-    const path = buildPath(appId);
-    const reader = createBuildSessionReader(deps);
+    const path = builderPath(appId);
+    const reader = createBuilderSessionReader(deps);
     const authHeaders = () => bearer(getToken);
     const writeHeaders = async (idempotencyKey) => ({
         ...(await authHeaders()),

package/dist/modules/{build.types.d.ts → builder.types.d.ts}

@@ -5,35 +5,35 @@
  * no answer clears — being out of credits is the one that exists today — and it
  * resumes once that condition does. `reason` says which.
  */
-export type BuildStatus = "idle" | "running" | "waiting" | "blocked" | "error";
+export type BuilderStatus = "idle" | "running" | "waiting" | "blocked" | "error";
 /**
  * Why a turn is suspended, and therefore what to render.
  *
- * All three are answerable with {@link BuildSession.respond | respond()}, and each
+ * All three are answerable with {@link BuilderSession.respond | respond()}, and each
  * wants a different affordance: a form, a picker, an approve/reject. Being out of
  * credits is deliberately *not* one of these — it is `blocked`, because no
  * response resolves it.
  */
-export type BuildWaitingKind = "input" | "choice" | "approval";
+export type BuilderWaitingKind = "input" | "choice" | "approval";
 /**
  * The waitpoint holding a turn open.
  */
-export interface BuildWaitingOn {
+export interface BuilderWaitingOn {
     /** What kind of answer resolves it. */
-    kind: BuildWaitingKind;
+    kind: BuilderWaitingKind;
     /** The id to answer with. It is the tool call's id, and it goes stale when the turn moves on. */
     waitpointId: string;
     /** The tool that asked, when the server names one. Display only. */
     toolName?: string;
 }
 /**
- * A build session's current state.
+ * A builder session's current state.
  */
-export interface BuildState {
+export interface BuilderState {
     /** Where the turn stands. */
-    status: BuildStatus;
+    status: BuilderStatus;
     /** Present only while `status` is `"waiting"`. */
-    waitingOn?: BuildWaitingOn;
+    waitingOn?: BuilderWaitingOn;
     /** Why a `blocked` turn is blocked. `"quota"` is out of credits. */
     reason?: string;
     /** The turn this state belongs to, so a state arriving after a reconnect can be told from a stale one. */
@@ -52,7 +52,7 @@ export interface BuildState {
 /**
  * One tool call inside a streamed message.
  */
-export interface BuildToolCall {
+export interface BuilderToolCall {
     /** The call's id. When this call is a waitpoint, this is the `waitpointId` to answer with. */
     id: string;
     /** The tool's name. */
@@ -62,7 +62,7 @@ export interface BuildToolCall {
     /** Whether this call is waiting on a person. */
     requiresUserInput: boolean;
     /** What kind of answer it wants, when it is waiting. */
-    waitingOnKind: BuildWaitingKind | null;
+    waitingOnKind: BuilderWaitingKind | null;
     /**
      * The call's arguments, as the raw JSON string the model produced.
      *
@@ -81,11 +81,11 @@ export interface BuildToolCall {
 /**
  * One message in a build conversation.
  *
- * The same shape from the stream and from {@link BuildSessionReader.listMessages | listMessages()},
+ * The same shape from the stream and from {@link BuilderSessionReader.listMessages | listMessages()},
  * so reconciling after an outage cannot produce a different transcript than the
  * one that was streamed.
  */
-export interface BuildMessage {
+export interface BuilderMessage {
     /** The message's id, and the key it is replaced under. */
     messageId: string;
     /** Who wrote it. A partner's own user messages come back on the stream too. */
@@ -93,14 +93,14 @@ export interface BuildMessage {
     /** The message text. */
     content: string;
     /** The tool calls this message carries. */
-    toolCalls: BuildToolCall[];
+    toolCalls: BuilderToolCall[];
 }
 /**
- * The event types a build session emits.
+ * The event types a builder session emits.
  */
-export type BuildEventType = "state.changed" | "turn.started" | "turn.finished" | "message.updated" | "error" | "conversation.reset" | "files.changed";
+export type BuilderEventType = "state.changed" | "turn.started" | "turn.finished" | "message.updated" | "error" | "conversation.reset" | "files.changed";
 /** Fields every event carries. */
-interface BuildEventBase {
+interface BuilderEventBase {
     /**
      * The journal sequence. Monotonic per session, and the resume cursor — the SDK
      * tracks it for you across reconnects.
@@ -110,7 +110,7 @@ interface BuildEventBase {
     turnId?: string;
 }
 /**
- * One event from a build session.
+ * One event from a builder session.
  *
  * A discriminated union: switch on `type` and `data` narrows with it.
  *
@@ -118,18 +118,18 @@ interface BuildEventBase {
  * in-progress assistant message on every tick, so the contract is last-write-wins
  * per `messageId` — replace what you hold, never append. Text still arrives
  * progressively; there is simply no delta event.
- * {@link BuildSessionReader.streamText | streamText()} is the append-shaped view,
+ * {@link BuilderSessionReader.streamText | streamText()} is the append-shaped view,
  * for UIs that want one.
  */
-export type BuildEvent = ({
+export type BuilderEvent = ({
     /** A turn started, finished, changed state, or failed. */
     type: "turn.started" | "turn.finished" | "state.changed" | "error";
-    data: BuildState;
-} & BuildEventBase) | ({
+    data: BuilderState;
+} & BuilderEventBase) | ({
     /** A message was written or rewritten. Replace what you hold for this `messageId`. */
     type: "message.updated";
-    data: BuildMessage;
-} & BuildEventBase) | ({
+    data: BuilderMessage;
+} & BuilderEventBase) | ({
     /**
      * The conversation was rewritten underneath you (a checkpoint restore, a
      * branch sync), or the app's files changed outside a turn. Both carry no
@@ -137,16 +137,16 @@ export type BuildEvent = ({
      */
     type: "conversation.reset" | "files.changed";
     data: Record<string, never>;
-} & BuildEventBase);
+} & BuilderEventBase);
 /**
  * An answer to a waitpoint.
  *
  * Discriminated on `kind`, which is checked against the *live* waitpoint: sending
  * an approval to a question is a 409 rather than a silent coercion. `waitpointId`
- * comes from {@link BuildWaitingOn.waitpointId}, and a stale one is also a 409 —
+ * comes from {@link BuilderWaitingOn.waitpointId}, and a stale one is also a 409 —
  * so read the current state rather than remembering an id across turns.
  */
-export type BuildResponse = {
+export type BuilderResponse = {
     /** Answering an approval: a decision, and nothing else. */
     kind: "approval";
     /** The waitpoint to answer. */
@@ -166,8 +166,8 @@ export type BuildResponse = {
      */
     value?: Record<string, unknown>;
 };
-/** Options for {@link BuildSession.sendMessage | sendMessage()}. */
-export interface SendBuildMessageOptions {
+/** Options for {@link BuilderSession.sendMessage | sendMessage()}. */
+export interface SendBuilderMessageOptions {
     /** Attachments, as URLs the builder can fetch. */
     fileUrls?: string[];
     /**
@@ -183,35 +183,35 @@ export interface SendBuildMessageOptions {
      */
     idempotencyKey?: string;
 }
-/** Options for {@link BuildSession.respond | respond()}. */
-export interface RespondToBuildOptions {
-    /** See {@link SendBuildMessageOptions.idempotencyKey}. */
+/** Options for {@link BuilderSession.respond | respond()}. */
+export interface RespondToBuilderOptions {
+    /** See {@link SendBuilderMessageOptions.idempotencyKey}. */
     idempotencyKey?: string;
 }
 /** The turn a write started. */
-export interface BuildTurnRef {
+export interface BuilderTurnRef {
     /** The session the turn runs in. Always the app id. */
     sessionId: string;
     /**
      * The turn's id.
      *
      * Carried on every event the turn emits, and the id
-     * {@link BuildSessionReader.getTurn | getTurn()} and
-     * {@link BuildSessionReader.waitForTurn | waitForTurn()} take.
+     * {@link BuilderSessionReader.getTurn | getTurn()} and
+     * {@link BuilderSessionReader.waitForTurn | waitForTurn()} take.
      */
     turnId: string;
 }
 /** One turn's outcome. */
-export interface BuildTurn {
+export interface BuilderTurn {
     /** The turn asked about. */
     turnId: string;
     /** Whether this is the turn running right now, rather than a settled one read back from the journal. */
     live: boolean;
     /** The state the turn is in, or the last one it reached. */
-    state: BuildState;
+    state: BuilderState;
 }
-/** Options for {@link BuildSession.createGrant | createGrant()}. */
-export interface CreateBuildGrantOptions {
+/** Options for {@link BuilderSession.createGrant | createGrant()}. */
+export interface CreateBuilderGrantOptions {
     /**
      * How long the grant lives.
      *
@@ -230,17 +230,17 @@ export interface CreateBuildGrantOptions {
     subject?: string;
 }
 /**
- * A read-only credential for one build session.
+ * A read-only credential for one builder session.
  *
  * The only Base44 credential that should ever reach a browser: it cannot send a
  * message, answer a waitpoint, cancel a turn, or touch any other app. That
  * asymmetry is the design — reads go browser to Base44 directly, writes go
  * through your server — and it is why a leaked grant cannot spend your credits.
  */
-export interface BuildGrant {
+export interface BuilderGrant {
     /** The session it reads. Always the app id. */
     sessionId: string;
-    /** The grant's id, for {@link BuildSession.revokeGrant | revokeGrant()}. */
+    /** The grant's id, for {@link BuilderSession.revokeGrant | revokeGrant()}. */
     grantId: string;
     /** The token itself. Hand this to the browser; hand it nothing else. */
     token: string;
@@ -251,8 +251,8 @@ export interface BuildGrant {
     /** The stream endpoint, absolute. Useful for a client that is not this SDK. */
     eventsUrl: string;
 }
-/** Options for {@link BuildSessionReader.listMessages | listMessages()}. */
-export interface ListBuildMessagesOptions {
+/** Options for {@link BuilderSessionReader.listMessages | listMessages()}. */
+export interface ListBuilderMessagesOptions {
     /**
      * The cursor from a previous page's `nextAfter`.
      *
@@ -272,14 +272,14 @@ export interface ListBuildMessagesOptions {
     limit?: number;
 }
 /** One page of conversation history. */
-export interface BuildMessagePage {
+export interface BuilderMessagePage {
     /** The page, oldest first. */
-    messages: BuildMessage[];
+    messages: BuilderMessage[];
     /** The cursor for the next page, or `null` at the end of the history. */
     nextAfter: string | null;
 }
 /** Options for the subscription forms. */
-export interface SubscribeToBuildOptions {
+export interface SubscribeToBuilderOptions {
     /**
      * Where to resume from.
      *
@@ -303,31 +303,31 @@ export interface SubscribeToBuildOptions {
     /** Stops the subscription when aborted, the same as calling the returned unsubscribe. */
     signal?: AbortSignal;
 }
-/** Options for {@link BuildSessionReader.waitForTurn | waitForTurn()}. */
+/** Options for {@link BuilderSessionReader.waitForTurn | waitForTurn()}. */
 export interface WaitForTurnOptions {
-    /** Gives up waiting when aborted. The turn itself is unaffected — use {@link BuildSession.cancel | cancel()} to stop it. */
+    /** Gives up waiting when aborted. The turn itself is unaffected — use {@link BuilderSession.cancel | cancel()} to stop it. */
     signal?: AbortSignal;
 }
 /**
- * A build session, read-only.
+ * A builder session, read-only.
  *
  * What a grant can do. Obtained from
- * {@link createBuildSession | createBuildSession()}, which is the browser's entry
- * point; the server-side {@link BuildSession} adds the writes on top.
+ * {@link createBuilderSession | createBuilderSession()}, which is the browser's entry
+ * point; the server-side {@link BuilderSession} adds the writes on top.
  */
-export interface BuildSessionReader {
-    /** The app this session builds. A build session *is* an app — there is no separate session to open. */
+export interface BuilderSessionReader {
+    /** The app this session builds. A builder session *is* an app — there is no separate session to open. */
     readonly appId: string;
     /**
      * The session's current state.
      *
      * The supported polling floor, for a client that cannot hold a connection open.
-     * Anything that can should {@link BuildSessionReader.subscribe | subscribe()}
+     * Anything that can should {@link BuilderSessionReader.subscribe | subscribe()}
      * instead — this answers from the app itself on every call.
      *
      * @returns Where the build stands right now.
      */
-    getState(): Promise<BuildState>;
+    getState(): Promise<BuilderState>;
     /**
      * Reads conversation history, newest page first and oldest-first within a page.
      *
@@ -341,13 +341,13 @@ export interface BuildSessionReader {
      * ```typescript
      * let after: string | null | undefined = undefined;
      * do {
-     *   const page = await build.listMessages({ after });
+     *   const page = await builder.listMessages({ after });
      *   render(page.messages);
      *   after = page.nextAfter;
      * } while (after);
      * ```
      */
-    listMessages(options?: ListBuildMessagesOptions): Promise<BuildMessagePage>;
+    listMessages(options?: ListBuilderMessagesOptions): Promise<BuilderMessagePage>;
     /**
      * One turn's outcome, so a write's `turnId` is followable without the stream.
      *
@@ -359,7 +359,7 @@ export interface BuildSessionReader {
      *
      * @throws {Base44Error} 404 if the turn is not in the retained window.
      */
-    getTurn(turnId: string): Promise<BuildTurn>;
+    getTurn(turnId: string): Promise<BuilderTurn>;
     /**
      * Waits for a turn to stop, and resolves with the state it stopped in.
      *
@@ -374,18 +374,18 @@ export interface BuildSessionReader {
      * Resolves on `idle`, `error` *and* `blocked` — a build that ran out of credits
      * has stopped, and waiting for it to finish would wait forever.
      *
-     * @param turnId - The turn to wait for, from {@link BuildTurnRef.turnId}.
+     * @param turnId - The turn to wait for, from {@link BuilderTurnRef.turnId}.
      * @param options - An abort signal.
      * @returns The state the turn came to rest in.
      *
      * @example
      * ```typescript
-     * const { turnId } = await build.sendMessage('add a footer');
-     * const outcome = await build.waitForTurn(turnId);
+     * const { turnId } = await builder.sendMessage('add a footer');
+     * const outcome = await builder.waitForTurn(turnId);
      * if (outcome.status === 'waiting') await answer(outcome.waitingOn);
      * ```
      */
-    waitForTurn(turnId: string, options?: WaitForTurnOptions): Promise<BuildState>;
+    waitForTurn(turnId: string, options?: WaitForTurnOptions): Promise<BuilderState>;
     /**
      * Streams the build, calling back on every event.
      *
@@ -405,7 +405,7 @@ export interface BuildSessionReader {
      *
      * @example
      * ```typescript
-     * const unsubscribe = build.subscribe((event) => {
+     * const unsubscribe = builder.subscribe((event) => {
      *   switch (event.type) {
      *     case 'message.updated': upsert(event.data); break;   // by messageId
      *     case 'state.changed':   setStatus(event.data); break;
@@ -418,7 +418,7 @@ export interface BuildSessionReader {
      * unsubscribe();
      * ```
      */
-    subscribe(onEvent: (event: BuildEvent) => void, options?: SubscribeToBuildOptions): () => void;
+    subscribe(onEvent: (event: BuilderEvent) => void, options?: SubscribeToBuilderOptions): () => void;
     /**
      * The same stream, as an async iterable.
      *
@@ -435,12 +435,12 @@ export interface BuildSessionReader {
      *
      * @example
      * ```typescript
-     * for await (const event of build.stream()) {
+     * for await (const event of builder.stream()) {
      *   if (event.type === 'turn.finished') break;
      * }
      * ```
      */
-    stream(options?: SubscribeToBuildOptions): AsyncIterable<BuildEvent>;
+    stream(options?: SubscribeToBuilderOptions): AsyncIterable<BuilderEvent>;
     /**
      * The assistant's prose, as text to append.
      *
@@ -454,8 +454,8 @@ export interface BuildSessionReader {
      * made immutable.
      *
      * Ends when the turn does. Tool calls and waitpoints are not text and are not
-     * yielded: read them from {@link BuildSessionReader.subscribe | subscribe()} or
-     * {@link BuildSessionReader.getState | getState()} and render them as whatever
+     * yielded: read them from {@link BuilderSessionReader.subscribe | subscribe()} or
+     * {@link BuilderSessionReader.getState | getState()} and render them as whatever
      * your surface calls a card.
      *
      * @param options - Resume point and abort signal.
@@ -463,26 +463,26 @@ export interface BuildSessionReader {
      *
      * @example
      * ```typescript
-     * for await (const chunk of build.streamText()) {
+     * for await (const chunk of builder.streamText()) {
      *   process.stdout.write(chunk);
      * }
      * ```
      */
-    streamText(options?: SubscribeToBuildOptions): AsyncIterable<string>;
+    streamText(options?: SubscribeToBuilderOptions): AsyncIterable<string>;
 }
 /**
- * A build session, with the writes.
+ * A builder session, with the writes.
  *
  * What a principal's own credential can do, and therefore what belongs on your
- * server. Obtained from {@link PrincipalClient.build | asPrincipal(id).build(appId)}.
+ * server. Obtained from {@link PrincipalClient.builder | asPrincipal(id).builder(appId)}.
  *
  * Every write returns as soon as the turn is *accepted*, not when it is done: a
  * build takes minutes and no caller should hold a request open through one. The
  * turn's progress arrives on the stream, and
- * {@link BuildSessionReader.waitForTurn | waitForTurn()} is how a long-lived
+ * {@link BuilderSessionReader.waitForTurn | waitForTurn()} is how a long-lived
  * worker awaits the end of it.
  */
-export interface BuildSession extends BuildSessionReader {
+export interface BuilderSession extends BuilderSessionReader {
     /**
      * Starts a build turn.
      *
@@ -495,12 +495,12 @@ export interface BuildSession extends BuildSessionReader {
      *
      * @example
      * ```typescript
-     * const { turnId } = await build.sendMessage('add a footer', {
+     * const { turnId } = await builder.sendMessage('add a footer', {
      *   idempotencyKey: requestId,
      * });
      * ```
      */
-    sendMessage(content: string, options?: SendBuildMessageOptions): Promise<BuildTurnRef>;
+    sendMessage(content: string, options?: SendBuilderMessageOptions): Promise<BuilderTurnRef>;
     /**
      * Answers the waitpoint holding the turn open, and resumes it.
      *
@@ -513,13 +513,13 @@ export interface BuildSession extends BuildSessionReader {
      *
      * @example
      * ```typescript
-     * const { waitingOn } = await build.getState();
+     * const { waitingOn } = await builder.getState();
      * if (waitingOn?.kind === 'approval') {
-     *   await build.respond({ ...waitingOn, approved: true });
+     *   await builder.respond({ ...waitingOn, approved: true });
      * }
      * ```
      */
-    respond(response: BuildResponse, options?: RespondToBuildOptions): Promise<BuildTurnRef>;
+    respond(response: BuilderResponse, options?: RespondToBuilderOptions): Promise<BuilderTurnRef>;
     /**
      * Stops the running turn.
      *
@@ -529,7 +529,7 @@ export interface BuildSession extends BuildSessionReader {
      * Returns nothing rather than the state. The endpoint answers with the
      * builder's own internal status vocabulary, which the rest of this surface
      * deliberately renames, and the settled state arrives on the stream — or from
-     * {@link BuildSessionReader.getState | getState()} — in the public one.
+     * {@link BuilderSessionReader.getState | getState()} — in the public one.
      */
     cancel(): Promise<void>;
     /**
@@ -547,12 +547,12 @@ export interface BuildSession extends BuildSessionReader {
      * ```typescript
      * // POST /api/base44/grant, on your server
      * const userId = await requireSession(req);
-     * const grant = await base44.asPrincipal(userId).build(appId)
+     * const grant = await base44.asPrincipal(userId).builder(appId)
      *   .createGrant({ ttlSeconds: 900 });
      * return Response.json(grant);
      * ```
      */
-    createGrant(options?: CreateBuildGrantOptions): Promise<BuildGrant>;
+    createGrant(options?: CreateBuilderGrantOptions): Promise<BuilderGrant>;
     /**
      * Withdraws a grant before it expires.
      *

package/dist/platform-client.d.ts

@@ -27,7 +27,7 @@ export type { CreatePlatformClientConfig, PlatformClient, PrincipalClient };
  *
  * Nor a principal's own token: it can start builds and spend credits. The one
  * credential meant for a browser is a *grant* —
- * {@linkcode BuildSession.createGrant | createGrant()} — which reads one build
+ * {@linkcode BuilderSession.createGrant | createGrant()} — which reads one builder
  * session, expires in minutes, and cannot write.
  *
  * @param config - Configuration object for the platform client.
@@ -51,9 +51,9 @@ export type { CreatePlatformClientConfig, PlatformClient, PrincipalClient };
  * const asDana = base44.asPrincipal('user_42');
  *
  * // Drive the builder as them, and watch it happen.
- * const build = asDana.build(appId);
- * const { turnId } = await build.sendMessage('add a footer');
- * const outcome = await build.waitForTurn(turnId);
+ * const builder = asDana.builder(appId);
+ * const { turnId } = await builder.sendMessage('add a footer');
+ * const outcome = await builder.waitForTurn(turnId);
  *
  * // Or use the rest of the SDK as them.
  * const app = await asDana.forApp(appId);

package/dist/platform-client.js

@@ -1,6 +1,6 @@
 import { createAxiosClient } from "./utils/axios-client.js";
 import { createPlatformsModule } from "./modules/platforms.js";
-import { createBuildSessionModule } from "./modules/build.js";
+import { createBuilderSessionModule } from "./modules/builder.js";
 import { createPrincipalTokenStore } from "./utils/principal-tokens.js";
 import { createClient } from "./client.js";
 /**
@@ -30,7 +30,7 @@ import { createClient } from "./client.js";
  *
  * Nor a principal's own token: it can start builds and spend credits. The one
  * credential meant for a browser is a *grant* —
- * {@linkcode BuildSession.createGrant | createGrant()} — which reads one build
+ * {@linkcode BuilderSession.createGrant | createGrant()} — which reads one builder
  * session, expires in minutes, and cannot write.
  *
  * @param config - Configuration object for the platform client.
@@ -54,9 +54,9 @@ import { createClient } from "./client.js";
  * const asDana = base44.asPrincipal('user_42');
  *
  * // Drive the builder as them, and watch it happen.
- * const build = asDana.build(appId);
- * const { turnId } = await build.sendMessage('add a footer');
- * const outcome = await build.waitForTurn(turnId);
+ * const builder = asDana.builder(appId);
+ * const { turnId } = await builder.sendMessage('add a footer');
+ * const outcome = await builder.waitForTurn(turnId);
  *
  * // Or use the rest of the SDK as them.
  * const app = await asDana.forApp(appId);
@@ -84,9 +84,9 @@ export function createPlatformClient(config) {
         onError: options === null || options === void 0 ? void 0 : options.onError,
     });
     // A fourth, and for the same reason as the third: it carries no static
-    // credential. Every build call is made as a *principal*, whose token rotates,
+    // credential. Every builder call is made as a *principal*, whose token rotates,
     // so the token goes on the request rather than into the client.
-    const buildAxios = createAxiosClient({
+    const builderAxios = createAxiosClient({
         baseURL: `${serverUrl}/api`,
         onError: options === null || options === void 0 ? void 0 : options.onError,
     });
@@ -106,12 +106,12 @@ export function createPlatformClient(config) {
         return {
             externalId,
             getToken,
-            // Not cached, unlike `forApp`. A build session is a handful of closures
+            // Not cached, unlike `forApp`. A builder session is a handful of closures
             // over the token store rather than a client with sockets and an analytics
             // session, so there is nothing to reuse and nothing to leak.
-            build(appId) {
-                return createBuildSessionModule({
-                    axios: buildAxios,
+            builder(appId) {
+                return createBuilderSessionModule({
+                    axios: builderAxios,
                     appId,
                     serverUrl,
                     getToken,

package/dist/platform-client.types.d.ts

@@ -1,5 +1,5 @@
 import type { Base44Client, CreateClientOptions } from "./client.types.js";
-import type { BuildSession } from "./modules/build.types.js";
+import type { BuilderSession } from "./modules/builder.types.js";
 import type { PlatformsModule } from "./modules/platforms.types.js";
 /**
  * Configuration for creating a Base44 platform client.
@@ -48,7 +48,7 @@ export interface PrincipalClient {
     /** The identifier this principal was provisioned under. */
     readonly externalId: string;
     /**
-     * The build session for one app, driven as this principal.
+     * The builder session for one app, driven as this principal.
      *
      * This is the partner-facing builder: send a message, answer what the agent
      * asks, stop a turn, and watch the whole thing happen over one resumable
@@ -69,16 +69,16 @@ export interface PrincipalClient {
      *
      * @example
      * ```typescript
-     * const build = base44.asPrincipal('user_42').build(appId);
+     * const builder = base44.asPrincipal('user_42').builder(appId);
      *
-     * const { turnId } = await build.sendMessage('add a footer');
-     * const outcome = await build.waitForTurn(turnId);
+     * const { turnId } = await builder.sendMessage('add a footer');
+     * const outcome = await builder.waitForTurn(turnId);
      *
      * // The browser gets a read-only grant, and nothing else.
-     * const grant = await build.createGrant({ ttlSeconds: 900 });
+     * const grant = await builder.createGrant({ ttlSeconds: 900 });
      * ```
      */
-    build(appId: string): BuildSession;
+    builder(appId: string): BuilderSession;
     /**
      * A Base44 client for one app, acting as this principal.
      *
@@ -108,12 +108,12 @@ export interface PrincipalClient {
      * The raw access token for this principal, minting or renewing as needed.
      *
      * Most code should use {@link PrincipalClient.forApp | forApp()} or
-     * {@link PrincipalClient.build | build()} instead. Reach for this when you need
+     * {@link PrincipalClient.builder | builder()} instead. Reach for this when you need
      * to authenticate a request the SDK does not make for you.
      *
      * **Not the thing to send to a browser.** This token can start builds and spend
      * your credits. What a browser gets is a grant from
-     * {@link BuildSession.createGrant | createGrant()}, which reads one session and
+     * {@link BuilderSession.createGrant | createGrant()}, which reads one session and
      * writes nothing.
      *
      * Do not cache what this returns — it is already cached, and holding a copy is

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@base44-preview/sdk",
-  "version": "0.8.44-pr.265.8da157e",
+  "version": "0.8.44-pr.265.a1a63b2",
   "description": "JavaScript SDK for Base44 API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",