@superblocksteam/gateway 2.0.161 → 2.0.162-next.1

package/dist/sabs/app-state.js

@@ -0,0 +1,332 @@
+/**
+ * How long a dead start stays the answer for an application.
+ *
+ * Long enough to outlive the poll that follows a failed prompt, short enough
+ * that an app abandoned after a failure is not still reporting it later.
+ */
+export const DEFAULT_FAILED_START_TTL_MS = 30 * 60 * 1000;
+/**
+ * Cap on remembered dead starts, because nothing else evicts: an app whose
+ * start failed and that is never retried would otherwise hold its entry for
+ * the life of the process.
+ */
+export const MAX_FAILED_STARTS = 256;
+const DEFAULT_BRANCH_KEY = "default";
+/**
+ * How long an acknowledged start may go without its live owner renewing it.
+ * Long enough for a cold sandbox boot, short enough that a background start
+ * killed without recording anything stops pinning the app at "building".
+ */
+export const DEFAULT_PENDING_START_TTL_MS = 5 * 60 * 1000;
+/**
+ * What Gateway remembers about an application between turns.
+ *
+ * None of this is transport state, and none of it can be pushed onto the
+ * caller. Each entry compensates for something the protocol does not carry:
+ *
+ * - The plan, because approving one means re-sending it as `planContext`, and
+ *   a caller asked to echo markdown back paraphrases it - which silently
+ *   changes what gets built.
+ * - The dead start, because the call that failed has already returned. It is
+ *   the *next* call - a poll, or `get_app` - that would otherwise report
+ *   `unknown` and preview the untouched starter template as a finished app.
+ *
+ * It lives here rather than on the session peer so a socket owns a socket. It
+ * is a concrete class with no optional members: a collaborator that is always
+ * present cannot be confused at a call site with a fact that is absent.
+ */
+export class AppState {
+    acceptedStarts = new Map();
+    plans = new Map();
+    decisions = new Map();
+    publishes = new Map();
+    failedStarts = new Map();
+    pendingStarts = new Map();
+    failedStartTtlMs;
+    maxFailedStarts;
+    now;
+    pendingStartTtlMs;
+    revision = 0;
+    constructor(options = {}) {
+        this.failedStartTtlMs =
+            options.failedStartTtlMs ?? DEFAULT_FAILED_START_TTL_MS;
+        this.maxFailedStarts = options.maxFailedStarts ?? MAX_FAILED_STARTS;
+        this.now = options.now ?? (() => Date.now());
+        this.pendingStartTtlMs =
+            options.pendingStartTtlMs ?? DEFAULT_PENDING_START_TTL_MS;
+    }
+    pendingPlan(applicationId, requestedBranch) {
+        const plan = this.plans.get(applicationId);
+        return requestedBranch === undefined || plan?.branch === requestedBranch
+            ? plan
+            : undefined;
+    }
+    setPendingPlan(applicationId, plan) {
+        this.plans.set(applicationId, plan);
+    }
+    pendingDecision(applicationId, requestedBranch) {
+        const decision = this.decisions.get(applicationId);
+        return requestedBranch === undefined || decision?.branch === requestedBranch
+            ? decision
+            : undefined;
+    }
+    setPendingDecision(applicationId, decision) {
+        this.decisions.set(applicationId, decision);
+    }
+    /**
+     * The commit whose deploy `publish_app` handed back still running, so
+     * `check_publish_progress` can follow it without the caller carrying the id.
+     */
+    publishInFlight(applicationId) {
+        return this.publishes.get(applicationId)?.commitId;
+    }
+    publishStartedAtMs(applicationId, commitId) {
+        const publish = this.publishes.get(applicationId);
+        return publish?.commitId === commitId ? publish.startedAtMs : undefined;
+    }
+    setPublishInFlight(applicationId, commitId, startedAtMs = this.now()) {
+        const claim = ++this.revision;
+        this.publishes.set(applicationId, {
+            claim,
+            commitId,
+            missingSinceMs: undefined,
+            startedAtMs,
+        });
+        return claim;
+    }
+    claimPublishInFlight(applicationId, commitId, startedAtMs = this.now()) {
+        const current = this.publishes.get(applicationId);
+        const claim = ++this.revision;
+        this.publishes.set(applicationId, {
+            claim,
+            commitId,
+            missingSinceMs: current?.commitId === commitId ? current.missingSinceMs : undefined,
+            startedAtMs: current?.commitId === commitId ? current.startedAtMs : startedAtMs,
+        });
+        return claim;
+    }
+    noteMissingPublishStatus(applicationId, claim, atMs) {
+        const publish = this.publishes.get(applicationId);
+        if (publish?.claim !== claim) {
+            return undefined;
+        }
+        publish.missingSinceMs ??= atMs;
+        return Math.max(0, atMs - publish.missingSinceMs);
+    }
+    noteVisiblePublishStatus(applicationId, claim) {
+        const publish = this.publishes.get(applicationId);
+        if (publish?.claim === claim) {
+            publish.missingSinceMs = undefined;
+        }
+    }
+    clearPublishInFlight(applicationId, claim) {
+        if (this.publishes.get(applicationId)?.claim === claim) {
+            this.publishes.delete(applicationId);
+        }
+    }
+    /**
+     * Drop the plan alone, for a turn that ended on a decision that is not one.
+     * The decision it ended on is written separately and must survive this.
+     */
+    clearPendingPlan(applicationId) {
+        this.plans.delete(applicationId);
+    }
+    /** Both go together: a plan is one kind of decision Clark waits on. */
+    clearPending(applicationId) {
+        this.plans.delete(applicationId);
+        this.decisions.delete(applicationId);
+    }
+    markTurnStarted() {
+        return ++this.revision;
+    }
+    failedStart(scope, newerThanRevision) {
+        const keys = scope.branch === undefined
+            ? [...this.failedStarts.keys()].reverse()
+            : [failedStartKey(scope)];
+        const prefix = failedStartPrefix(scope);
+        let latest;
+        let latestRevision = Number.NEGATIVE_INFINITY;
+        for (const key of keys) {
+            if (!key.startsWith(prefix)) {
+                continue;
+            }
+            const entry = this.failedStarts.get(key);
+            if (!entry) {
+                continue;
+            }
+            if (this.now() - entry.atMs >= this.failedStartTtlMs) {
+                this.failedStarts.delete(key);
+                continue;
+            }
+            if (newerThanRevision !== undefined &&
+                entry.revision <= newerThanRevision) {
+                continue;
+            }
+            if (entry.revision > latestRevision) {
+                latest = entry.turn;
+                latestRevision = entry.revision;
+            }
+        }
+        return latest;
+    }
+    recordFailedStart(scope, turn, revision = this.markTurnStarted()) {
+        const key = failedStartKey(scope);
+        const acceptedRevision = this.acceptedStarts.get(acceptedStartKey(scope.applicationId, scope.branch));
+        if (acceptedRevision !== undefined && revision <= acceptedRevision) {
+            return;
+        }
+        const current = this.failedStarts.get(key);
+        if (current && current.revision > revision) {
+            return;
+        }
+        // Re-inserted rather than updated in place, so this key becomes the newest
+        // and the eviction below stays in insertion order.
+        this.failedStarts.delete(key);
+        this.failedStarts.set(key, {
+            atMs: this.now(),
+            revision,
+            turn: {
+                ...(scope.branch === undefined ? {} : { branch: scope.branch }),
+                ...turn,
+            },
+        });
+        for (const oldest of this.failedStarts.keys()) {
+            if (this.failedStarts.size <= this.maxFailedStarts) {
+                break;
+            }
+            this.failedStarts.delete(oldest);
+        }
+    }
+    claimReplacementEntitlement(scope, replyWhileClaimed) {
+        const turn = this.failedStart(scope);
+        if (turn?.recoveryAction !== "start_new_app") {
+            return undefined;
+        }
+        const replyBeforeConsumption = turn.reply;
+        delete turn.recoveryAction;
+        turn.reply = replyWhileClaimed;
+        return () => {
+            turn.recoveryAction = "start_new_app";
+            turn.reply = replyBeforeConsumption;
+        };
+    }
+    /** Forget every caller's dead start for the accepted application branch. */
+    clearFailedStarts(applicationId, branch, throughRevision = Number.POSITIVE_INFINITY) {
+        const acceptedKey = acceptedStartKey(applicationId, branch);
+        const acceptedRevision = this.acceptedStarts.get(acceptedKey);
+        if (acceptedRevision === undefined || throughRevision > acceptedRevision) {
+            this.acceptedStarts.delete(acceptedKey);
+            this.acceptedStarts.set(acceptedKey, throughRevision);
+        }
+        const suffix = `\u0000${failedStartBranchKey(branch)}`;
+        for (const key of [...this.failedStarts.keys()]) {
+            const entry = this.failedStarts.get(key);
+            if (entry &&
+                entry.revision <= throughRevision &&
+                key.startsWith(`${applicationId}\u0000`) &&
+                key.endsWith(suffix)) {
+                this.failedStarts.delete(key);
+            }
+        }
+    }
+    pendingStart(scope, idempotencyKey, token) {
+        const keys = scope.branch === undefined
+            ? [...this.pendingStarts.keys()].reverse()
+            : [failedStartKey(scope)];
+        const prefix = failedStartPrefix(scope);
+        for (const key of keys) {
+            if (!key.startsWith(prefix)) {
+                continue;
+            }
+            const entry = this.pendingStarts.get(key);
+            if (!entry) {
+                continue;
+            }
+            if (this.now() - entry.atMs >= this.pendingStartTtlMs) {
+                this.pendingStarts.delete(key);
+                continue;
+            }
+            if ((idempotencyKey !== undefined &&
+                entry.idempotencyKey !== idempotencyKey) ||
+                (token !== undefined && entry.revision !== token)) {
+                continue;
+            }
+            return {
+                ...(entry.idempotencyKey === undefined
+                    ? {}
+                    : { idempotencyKey: entry.idempotencyKey }),
+                ...(entry.retryAction ? { retryAction: entry.retryAction } : {}),
+                token: entry.revision,
+            };
+        }
+        return undefined;
+    }
+    recordPendingStart(scope, value = {}) {
+        const now = this.now();
+        for (const [pendingKey, pending] of this.pendingStarts) {
+            if (now - pending.atMs >= this.pendingStartTtlMs) {
+                this.pendingStarts.delete(pendingKey);
+            }
+        }
+        const key = failedStartKey(scope);
+        this.pendingStarts.delete(key);
+        const revision = ++this.revision;
+        this.pendingStarts.set(key, {
+            atMs: now,
+            revision,
+            ...value,
+        });
+        return revision;
+    }
+    keepPendingStartAlive(scope, token) {
+        const key = failedStartKey(scope);
+        const timer = setInterval(() => {
+            const pending = this.pendingStarts.get(key);
+            if (pending?.revision !== token) {
+                clearInterval(timer);
+                return;
+            }
+            pending.atMs = this.now();
+        }, Math.max(1, Math.floor(this.pendingStartTtlMs / 2)));
+        timer.unref();
+        return () => clearInterval(timer);
+    }
+    clearPendingStart(scope, idempotencyKey, throughRevision = Number.POSITIVE_INFINITY, token) {
+        const key = failedStartKey(scope);
+        const pending = this.pendingStarts.get(key);
+        if (pending &&
+            pending.revision <= throughRevision &&
+            (token === undefined || pending.revision === token) &&
+            (idempotencyKey === undefined ||
+                pending.idempotencyKey === idempotencyKey)) {
+            return this.pendingStarts.delete(key);
+        }
+        return false;
+    }
+    clearPendingStartsThrough(applicationId, revision) {
+        for (const [key, pending] of this.pendingStarts) {
+            if (pending.revision <= revision &&
+                key.startsWith(`${applicationId}\u0000`)) {
+                this.pendingStarts.delete(key);
+            }
+        }
+    }
+}
+/**
+ * Separated by NUL because no id can contain one. Any printable separator is a
+ * character an id could carry, and an id that carried it would key two
+ * different callers to the same entry.
+ */
+function failedStartKey(scope) {
+    return `${failedStartPrefix(scope)}${failedStartBranchKey(scope.branch)}`;
+}
+function acceptedStartKey(applicationId, branch) {
+    return `${applicationId}\u0000${failedStartBranchKey(branch)}`;
+}
+function failedStartPrefix(scope) {
+    return `${scope.applicationId}\u0000${scope.organizationId}\u0000${scope.userId}\u0000`;
+}
+function failedStartBranchKey(branch) {
+    return branch === undefined ? DEFAULT_BRANCH_KEY : `branch:${branch}`;
+}
+//# sourceMappingURL=app-state.js.map

package/dist/sabs/app-state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"app-state.js","sourceRoot":"","sources":["../../src/sabs/app-state.ts"],"names":[],"mappings":"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"}

package/dist/sabs/awaited-decision.d.ts

@@ -0,0 +1,49 @@
+import type { TurnDecision } from "./session-peer.js";
+/**
+ * What Clark is waiting on a human for, assembled from the pushes that carry
+ * it.
+ *
+ * Neither shape arrives whole. A plan opens with one message and streams in
+ * deltas, and the caller only has something to approve once the pieces are
+ * joined; a question arrives with its options in one of two different push
+ * types. Keeping that assembly here is what lets the turn ask a single
+ * question - "is Clark waiting on anyone?" - instead of tracking four fields
+ * to work it out.
+ */
+export declare class AwaitedDecision {
+    private readonly integrationRequestFingerprints;
+    private readonly integrations;
+    private planChunks;
+    private planMessageId;
+    private planTitle;
+    private choice;
+    /** A `plan` push: the start of a plan, replacing any plan before it. */
+    openPlan(input: {
+        messageId?: string;
+        title?: string;
+    }): void;
+    /** A `plan` or `plan-delta` push carrying more of the plan's text. */
+    appendPlan(content: string): void;
+    /** A `multi_choice` or `searchable_dropdown` push. */
+    askChoice(input: {
+        messageId?: string;
+        options: string[];
+        question: string;
+    }): void;
+    /** A headless integration setup request for the MCP host to fulfill. */
+    requireIntegration(input: {
+        configuration: Record<string, unknown>;
+        name?: string;
+        pluginId: string;
+        requestFingerprint: string;
+    }): void;
+    /** True once a plan has streamed any text, whether or not it has finished. */
+    hasPlan(): boolean;
+    /**
+     * The decision to report, preferring a plan over a question when both
+     * arrived in the same turn: a plan is what approve/refine acts on, and a
+     * question Clark asked on the way to it is not the turn's outcome.
+     */
+    decision(): TurnDecision | undefined;
+    private plan;
+}

package/dist/sabs/awaited-decision.js

@@ -0,0 +1,129 @@
+import { McpError } from "@modelcontextprotocol/sdk/types.js";
+import { getPluginConfigurationSchema } from "@superblocksteam/mcp-server";
+/** Matches library-shared AI_PLAN_STREAMING_END_MARKER. */
+const PLAN_STREAMING_END_MARKER = "[__SUPERBLOCKS_PLAN_DONE__]";
+/**
+ * The plugin's configuration form, from the schema bundled in the MCP server.
+ *
+ * Carrying it with the request is what keeps the host from having to ask for
+ * it: a separate schema tool call is a second approval prompt for a lookup
+ * that touches nothing. Superblocks can name a plugin the bundle has no
+ * schema for, and a missing form is no reason to drop the whole request.
+ */
+function pluginConfigurationForm(pluginId) {
+    try {
+        return getPluginConfigurationSchema(pluginId);
+    }
+    catch (error) {
+        if (error instanceof McpError) {
+            return undefined;
+        }
+        throw error;
+    }
+}
+/**
+ * What Clark is waiting on a human for, assembled from the pushes that carry
+ * it.
+ *
+ * Neither shape arrives whole. A plan opens with one message and streams in
+ * deltas, and the caller only has something to approve once the pieces are
+ * joined; a question arrives with its options in one of two different push
+ * types. Keeping that assembly here is what lets the turn ask a single
+ * question - "is Clark waiting on anyone?" - instead of tracking four fields
+ * to work it out.
+ */
+export class AwaitedDecision {
+    integrationRequestFingerprints = new Set();
+    integrations = [];
+    planChunks = [];
+    planMessageId;
+    planTitle;
+    choice;
+    /** A `plan` push: the start of a plan, replacing any plan before it. */
+    openPlan(input) {
+        this.planChunks = [];
+        if (input.messageId) {
+            this.planMessageId = input.messageId;
+        }
+        if (input.title?.trim()) {
+            this.planTitle = input.title.trim();
+        }
+    }
+    /** A `plan` or `plan-delta` push carrying more of the plan's text. */
+    appendPlan(content) {
+        if (content) {
+            this.planChunks.push(content);
+        }
+    }
+    /** A `multi_choice` or `searchable_dropdown` push. */
+    askChoice(input) {
+        this.choice = {
+            ...(input.messageId ? { messageId: input.messageId } : {}),
+            options: input.options,
+            question: input.question,
+        };
+    }
+    /** A headless integration setup request for the MCP host to fulfill. */
+    requireIntegration(input) {
+        const pluginId = input.pluginId === "restapi" ? "restapiintegration" : input.pluginId;
+        const { baseUrl, ...restConfiguration } = input.configuration;
+        const configuration = input.pluginId === "restapi"
+            ? {
+                ...restConfiguration,
+                ...(baseUrl !== undefined && restConfiguration.urlBase === undefined
+                    ? { urlBase: baseUrl }
+                    : {}),
+            }
+            : input.configuration;
+        if (this.integrationRequestFingerprints.has(input.requestFingerprint)) {
+            return;
+        }
+        const configurationSchema = pluginConfigurationForm(pluginId);
+        this.integrationRequestFingerprints.add(input.requestFingerprint);
+        this.integrations.push({
+            configuration,
+            ...(input.name !== undefined ? { name: input.name } : {}),
+            pluginId,
+            ...(configurationSchema ? { configurationSchema } : {}),
+        });
+    }
+    /** True once a plan has streamed any text, whether or not it has finished. */
+    hasPlan() {
+        return this.plan() !== undefined;
+    }
+    /**
+     * The decision to report, preferring a plan over a question when both
+     * arrived in the same turn: a plan is what approve/refine acts on, and a
+     * question Clark asked on the way to it is not the turn's outcome.
+     */
+    decision() {
+        if (this.integrations.length > 0) {
+            return {
+                integrations: [...this.integrations],
+                kind: "missing_integrations",
+            };
+        }
+        const plan = this.plan();
+        if (plan) {
+            return {
+                kind: "plan",
+                ...(this.planMessageId ? { messageId: this.planMessageId } : {}),
+                plan,
+                ...(this.planTitle ? { title: this.planTitle } : {}),
+            };
+        }
+        return this.choice ? { kind: "multi_choice", ...this.choice } : undefined;
+    }
+    plan() {
+        if (this.planChunks.length === 0) {
+            return undefined;
+        }
+        const plan = this.planChunks
+            .join("")
+            .split(PLAN_STREAMING_END_MARKER)
+            .join("")
+            .trimEnd();
+        return plan || undefined;
+    }
+}
+//# sourceMappingURL=awaited-decision.js.map

package/dist/sabs/awaited-decision.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"awaited-decision.js","sourceRoot":"","sources":["../../src/sabs/awaited-decision.ts"],"names":[],"mappings":"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"}

package/dist/sabs/editor-client-methods.d.ts

@@ -1,4 +1,4 @@
-import type { PromptContextIntegration, SdkApiExecutionResult } from "@superblocksteam/library-shared/types";
+import type { EditorHasDefaultStructure, PromptContextIntegration, SdkApiExecutionResult } from "@superblocksteam/library-shared/types";
 import { type MethodHandlers, type RequestContextBase } from "@superblocksteam/shared";
 import type { OrchestratorClient } from "../orchestrator/client.js";
 import type { SuperblocksServerClient } from "../server/client.js";
@@ -6,7 +6,7 @@ export type IntegrationExecuteResult = {
     error?: string;
     response?: string;
 };
-type IntegrationExecutePayload = {
+export type IntegrationExecutePayload = {
     integrationHint?: {
         displayName?: string;
         name: string;
@@ -26,6 +26,7 @@ export type ClarkMessage = {
         subText?: string;
     }>;
     content?: string;
+    gatewayObserverSource?: "browser";
     header?: string;
     id?: string;
     name?: string;
@@ -50,14 +51,29 @@ export type ClarkMessage = {
 export type ClarkPeerEvent = {
     kind: "message";
     message: ClarkMessage;
+} | {
+    configuration: Record<string, unknown>;
+    kind: "missing_integration";
+    name?: string;
+    pluginId: string;
+    requestFingerprint: string;
 } | {
     kind: "change_info";
     label: string;
 } | {
     kind: "draft_state";
     hasDraft: boolean;
+} | {
+    hasDefaultStructure: EditorHasDefaultStructure;
+    kind: "editor_structure";
 } | {
     kind: "generation_state";
+    /**
+     * The generation this state is about. Absent from dev servers that
+     * predate the field, which is why a turn cannot require it.
+     */
+    generationId?: string;
+    gatewayObserverSource?: "browser";
     hasError?: boolean;
     hasSuggestions?: boolean;
     state: string;
@@ -86,6 +102,9 @@ export type EditorSessionContext = {
     sessionToken: string;
     waitUntilFilesSynced: () => Promise<boolean>;
 };
+export type IntegrationExecutionContext = Pick<EditorSessionContext, "apiKey" | "orchestrator" | "organizationId" | "profileKey" | "server" | "sessionToken"> & {
+    applicationId?: string;
+};
 export type EditorClientMethodDeps = {
     getContext: () => EditorSessionContext | undefined;
     /**
@@ -115,7 +134,7 @@ export type EditorClientMethodDeps = {
  * other stored-credential integrations execute here; interactive IdP auth
  * surfaces as an error asking the user to authenticate in the editor.
  */
-export declare function executeRequestToIntegrationViaOrchestrator(context: EditorSessionContext, payload: IntegrationExecutePayload): Promise<IntegrationExecuteResult>;
+export declare function executeRequestToIntegrationViaOrchestrator(context: IntegrationExecutionContext, payload: IntegrationExecutePayload): Promise<IntegrationExecuteResult>;
 /**
  * Prefills Clark's promptContext.integrations the same way the editor does.
  */
@@ -132,7 +151,7 @@ export declare function mapSdkExecutionResponse(response: unknown): SdkApiExecut
  * and takes the in-flight Clark build down with it. A browser editor answers
  * all of them, so a held gateway socket has to as well.
  *
- * Keyed on `EditorClientMethods` rather than a hand-kept list so that a method
+ * Keyed on `GatewayClientMethods` rather than a hand-kept list so that a method
  * added to the protocol upstream fails this package's typecheck instead of
  * reaching a sandbox and crashing it. Same handler surface as
  * `createEditorHandlers` in vite-plugin-file-sync's dev-server-ws-smoke-client,
@@ -144,4 +163,3 @@ export declare function mapSdkExecutionResponse(response: unknown): SdkApiExecut
  * and surface progress over MCP.
  */
 export declare function createEditorClientMethods(getListener?: () => ClarkPeerListener | undefined, onInbound?: (method: string) => void, deps?: EditorClientMethodDeps): MethodHandlers<Record<string, never>, Record<string, never>, RequestContextBase>;
-export {};