@fork-api/chat-sdk 0.1.178 → 0.1.181

package/dist/index.d.cts

@@ -1,6 +1,50 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, ReactElement, ComponentType } from 'react';
 
+/**
+ * DOM element picker — the Chrome-DevTools-inspect experience for the chat
+ * panel. While active it paints a highlight overlay + label over whatever
+ * host-page element the cursor is on; clicking captures a structured context
+ * blob for the agent, Esc cancels.
+ *
+ * The overlay mounts directly on document.body (NOT inside the panel's
+ * shadow root) so it can sit over host elements, and it is pointer-events:
+ * none so document.elementFromPoint() resolves the real host target.
+ * Everything inside the Fork panel/launcher hosts is ignored — hovering the
+ * panel clears the highlight, clicking it neither selects nor cancels.
+ */
+interface SelectedElementContext {
+    tag: string;
+    id?: string;
+    classes?: string[];
+    selector?: string;
+    componentName?: string;
+    text?: string;
+    html?: string;
+    rect?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+}
+
+/** Image attachment riding on a fork prompt (raw base64 + media type). */
+interface ForkPromptAttachment {
+    mediaType: string;
+    data: string;
+}
+/** Options for submitting a prompt from the chat panel. */
+interface ForkSubmitOptions {
+    /** Follow-up on this fork (otherwise a new fork is composed). */
+    forkId?: string | null;
+    /** Force a new fork even when one exists for the target. */
+    forceNew?: boolean;
+    /** Screenshots pasted/uploaded into the composer. */
+    attachments?: ForkPromptAttachment[];
+    /** DOM element the user picked on the page for context. */
+    selectedElement?: SelectedElementContext | null;
+}
 interface Fork {
     id: string;
     userId: string;
@@ -63,7 +107,8 @@ interface ForkProviderBase {
     shared?: ForkSharedRegistry;
 }
 /**
- * User identity — provide EITHER userId (optionally with userHash) OR authUrl:
+ * User identity — provide EITHER userId (optionally with userHash or userJwt)
+ * OR authUrl:
  *
  * - `userId` alone: Client-asserted, no server verification (dev/testing only).
  * - `userId` + `userHash`: Host-brokered verified identity. Your backend
@@ -71,12 +116,37 @@ interface ForkProviderBase {
  *   both as props. Fork never touches cookies or Web Storage for identity, so
  *   this is the required mode for embedded/iframe contexts where third-party
  *   cookies are blocked (e.g. app-store review environments).
- * - `authUrl`: URL on your backend that returns `{ userId, userHash }`.
- *   The SDK calls this on mount (same-origin, cookies sent automatically).
- *   Relies on the host's cookie session, so it does not work where the host
- *   page's cookies are third-party — prefer the userHash prop mode there.
+ * - `userJwt`: OPTIONAL and ADDITIVE — it carries custom user attributes, it
+ *   does not replace the identity you already send. Your backend signs HS256
+ *   with a key DERIVED from your sk_ — `HMAC-SHA256(sk_, "fork-user-jwt-v1")`,
+ *   never sk_ itself, which would let your own auth endpoint be used as a
+ *   signing oracle. Payload: `{ sub: userId, attrs: { role, vertical, ... } }`
+ *   with `audience: "fork"` and an `expiresIn` (both required, max 7 days).
+ *   Everything in `attrs` becomes a custom user attribute visible in Fork
+ *   admin. Because the claim sits inside the signature, an end user cannot
+ *   forge it from devtools — which is why attributes ride here and not in a
+ *   plain prop. Keep sending `userId` + `userHash` alongside it.
+ * - `authUrl`: URL on your backend that returns `{ userId, userHash }`, plus
+ *   `userJwt` if you want attributes. The SDK calls it on mount (same-origin,
+ *   cookies sent automatically). Relies on the host's cookie session, so it
+ *   does not work where the host page's cookies are third-party — prefer the
+ *   prop modes there.
+ *
+ * `userHash` remains the universal credential and is NOT deprecated: it is what
+ * authenticates every request the SDK makes. `userJwt` is stamped on the
+ * provider's own calls, which is where attributes get recorded — one such call
+ * per mount is all it takes, since the server leaves stored attributes untouched
+ * on requests that carry no token.
+ *
+ * Adding attributes to an existing integration is therefore purely additive:
+ * return one more field from the endpoint you already have. Nothing you send
+ * today changes meaning, and rolling it back is deleting that field.
  *
- * In either verified mode, if the user is also a Fork tenant operator (their
+ * Expiry is required and capped at 7 days; 24h is a reasonable choice. An
+ * expired token costs you attribute freshness, never access, because `userHash`
+ * is still carrying the identity.
+ *
+ * In any verified mode, if the user is also a Fork tenant operator (their
  * email matches a fork_users row with a user_roles entry on this tenant), the
  * SDK transparently enters admin mode and acts as their mapped end-user — set
  * the mapping in Fork's Team Settings → End user.
@@ -84,11 +154,13 @@ interface ForkProviderBase {
 type ForkProviderProps = ForkProviderBase & ({
     userId: string;
     userHash?: string;
+    userJwt?: string;
     authUrl?: never;
 } | {
     authUrl: string;
     userId?: never;
     userHash?: never;
+    userJwt?: never;
 });
 interface ForkBoundaryRegistration {
     id: string;
@@ -268,11 +340,8 @@ interface ForkPanelProps {
     targetId?: string;
     targetLabel?: string;
     historyMode?: "slot" | "boundary" | "none";
-    onSubmit: (prompt: string, targetId: string, containerId?: string | null, opts?: {
-        forkId?: string | null;
-        forceNew?: boolean;
-    }) => void;
-    onUndo?: (targetId: string) => Promise<any>;
+    onSubmit: (prompt: string, targetId: string, containerId?: string | null, opts?: ForkSubmitOptions) => void;
+    onUndo?: (targetId: string, forkId?: string | null) => Promise<any>;
     onClose: () => void;
     baseUrl?: string;
     apiKey?: string;
@@ -302,10 +371,7 @@ declare function useFork(): {
     runs: Record<string, ForkRun>;
     open: () => void;
     close: () => void;
-    startFork: (prompt: string, slotId?: string, containerId?: string | null, opts?: {
-        forkId?: string | null;
-        forceNew?: boolean;
-    }) => Promise<void>;
+    startFork: (prompt: string, slotId?: string, containerId?: string | null, opts?: ForkSubmitOptions) => Promise<void>;
     undoFork: (slotId: string) => Promise<any>;
     adoptRunningFork: (forkId: string) => Promise<void>;
 };
@@ -318,11 +384,8 @@ declare function useBoundaryFork(boundaryId: string): {
     runs: Record<string, ForkRun>;
     open: () => void;
     close: () => void;
-    startFork: (prompt: string, containerId?: string | null, opts?: {
-        forkId?: string | null;
-        forceNew?: boolean;
-    }) => Promise<void>;
-    undoFork: () => Promise<any>;
+    startFork: (prompt: string, containerId?: string | null, opts?: ForkSubmitOptions) => Promise<void>;
+    undoFork: (forkId?: string | null) => Promise<any>;
     adoptRunningFork: (forkId: string) => Promise<void>;
 };
 
@@ -332,22 +395,16 @@ declare function useForkChatPanel(options: ForkChatPanelOptions): {
     targetId: string;
     targetLabel: string | undefined;
     historyMode: "slot" | "boundary";
-    submit: (prompt: string, submittedTargetId?: string, containerId?: string | null, opts?: {
-        forkId?: string | null;
-        forceNew?: boolean;
-    }) => Promise<void>;
-    undo: (submittedTargetId?: string) => Promise<any>;
+    submit: (prompt: string, submittedTargetId?: string, containerId?: string | null, opts?: ForkSubmitOptions) => Promise<void>;
+    undo: (submittedTargetId?: string, forkId?: string | null) => Promise<any>;
     buttonProps: {
         onClick: () => void;
         hasNotification: boolean;
         activity: ForkActivitySummary;
     };
     panelProps: {
-        onSubmit: (prompt: string, submittedTargetId?: string, containerId?: string | null, opts?: {
-            forkId?: string | null;
-            forceNew?: boolean;
-        }) => Promise<void>;
-        onUndo: (submittedTargetId?: string) => Promise<any>;
+        onSubmit: (prompt: string, submittedTargetId?: string, containerId?: string | null, opts?: ForkSubmitOptions) => Promise<void>;
+        onUndo: (submittedTargetId?: string, forkId?: string | null) => Promise<any>;
         onClose: (() => void) | (() => void);
         baseUrl: string;
         apiKey: string;
@@ -363,11 +420,8 @@ declare function useForkChatPanel(options: ForkChatPanelOptions): {
         error: string | null;
         runs: Record<string, ForkRun>;
     } | {
-        onSubmit: (prompt: string, submittedTargetId?: string, containerId?: string | null, opts?: {
-            forkId?: string | null;
-            forceNew?: boolean;
-        }) => Promise<void>;
-        onUndo: (submittedTargetId?: string) => Promise<any>;
+        onSubmit: (prompt: string, submittedTargetId?: string, containerId?: string | null, opts?: ForkSubmitOptions) => Promise<void>;
+        onUndo: (submittedTargetId?: string, forkId?: string | null) => Promise<any>;
         onClose: (() => void) | (() => void);
         baseUrl: string;
         apiKey: string;
@@ -397,22 +451,16 @@ declare function useForkChatPanel(options: ForkChatPanelOptions): {
     targetId: string;
     targetLabel: string | undefined;
     historyMode: "slot" | "boundary";
-    submit: (prompt: string, submittedTargetId?: string, containerId?: string | null, opts?: {
-        forkId?: string | null;
-        forceNew?: boolean;
-    }) => Promise<void>;
-    undo: (submittedTargetId?: string) => Promise<any>;
+    submit: (prompt: string, submittedTargetId?: string, containerId?: string | null, opts?: ForkSubmitOptions) => Promise<void>;
+    undo: (submittedTargetId?: string, forkId?: string | null) => Promise<any>;
     buttonProps: {
         onClick: () => void;
         hasNotification: boolean;
         activity: ForkActivitySummary;
     };
     panelProps: {
-        onSubmit: (prompt: string, submittedTargetId?: string, containerId?: string | null, opts?: {
-            forkId?: string | null;
-            forceNew?: boolean;
-        }) => Promise<void>;
-        onUndo: (submittedTargetId?: string) => Promise<any>;
+        onSubmit: (prompt: string, submittedTargetId?: string, containerId?: string | null, opts?: ForkSubmitOptions) => Promise<void>;
+        onUndo: (submittedTargetId?: string, forkId?: string | null) => Promise<any>;
         onClose: (() => void) | (() => void);
         baseUrl: string;
         apiKey: string;
@@ -428,11 +476,8 @@ declare function useForkChatPanel(options: ForkChatPanelOptions): {
         error: string | null;
         runs: Record<string, ForkRun>;
     } | {
-        onSubmit: (prompt: string, submittedTargetId?: string, containerId?: string | null, opts?: {
-            forkId?: string | null;
-            forceNew?: boolean;
-        }) => Promise<void>;
-        onUndo: (submittedTargetId?: string) => Promise<any>;
+        onSubmit: (prompt: string, submittedTargetId?: string, containerId?: string | null, opts?: ForkSubmitOptions) => Promise<void>;
+        onUndo: (submittedTargetId?: string, forkId?: string | null) => Promise<any>;
         onClose: (() => void) | (() => void);
         baseUrl: string;
         apiKey: string;
@@ -791,6 +836,12 @@ interface LoadManifestInput {
     userId: string;
     /** Optional userHash for HMAC verification. */
     userHash?: string;
+    /**
+     * Optional attribute-bearing token (see ForkProviderProps). Sent so the
+     * manifest fetch — which runs on every mount, for every user, not just
+     * operators — is what records the tenant's custom user attributes.
+     */
+    userJwt?: string;
     /** Authorized explicit container lookup, used for container-bound previews. */
     containerId?: string;
     /** Additional trusted headers, e.g. preview session headers. */
@@ -817,4 +868,4 @@ declare function clearCachedManifest(tenantId: string, appId: string, userId: st
  */
 declare function manifestDiffers(a: Manifest | null, b: Manifest | null): boolean;
 
-export { type AdminContainer, type AdminContext, type EnsureFeatureInput, type EnsureLlmJobsInput, type Fork, type ForkActivity, type ForkActivitySummary, type ForkActivityTargetKind, type ForkBoundaryDefinition, ForkBoundaryUI, ForkButton, ForkChatInterface, type ForkChatInterfaceProps, type ForkChatPanelOptions, type ForkChatTarget, type ForkDataClient, type ForkDataClientConfig, type ForkDataSource, type ForkDataStatus, type ForkEntityRef, type ForkEvent, type ForkFeature, type ForkFeatureKind, type ForkFeatureOption, type ForkFeatureValue, type ForkLlmJob, type ForkLlmJobStatus, ForkPanel, ForkProvider, type ForkProviderProps, type ForkSharedRegistry, ForkSlot, type ForkSlotProps, type ForkState, ForkUI, type LoadManifestInput, type Manifest, type ManifestEntry, type ManifestModuleEntry, type QueryLlmJobsInput, type QueryValuesInput, type SetOptionsInput, type SetValuesInput, type UseForkFeatureValuesInput, type UseForkLlmJobsInput, clearCachedManifest, createForkDataClient, forkEntityValueKey, forkable, loadManifest, manifestDiffers, readCachedManifest, registerForkShared, useBoundaryFork, useFork, useForkChatPanel, useForkDataClient, useForkDataMutation, useForkFeatureValues, useForkLlmJobs, writeCachedManifest };
+export { type AdminContainer, type AdminContext, type EnsureFeatureInput, type EnsureLlmJobsInput, type Fork, type ForkActivity, type ForkActivitySummary, type ForkActivityTargetKind, type ForkBoundaryDefinition, ForkBoundaryUI, ForkButton, ForkChatInterface, type ForkChatInterfaceProps, type ForkChatPanelOptions, type ForkChatTarget, type ForkDataClient, type ForkDataClientConfig, type ForkDataSource, type ForkDataStatus, type ForkEntityRef, type ForkEvent, type ForkFeature, type ForkFeatureKind, type ForkFeatureOption, type ForkFeatureValue, type ForkLlmJob, type ForkLlmJobStatus, ForkPanel, type ForkPromptAttachment, ForkProvider, type ForkProviderProps, type ForkSharedRegistry, ForkSlot, type ForkSlotProps, type ForkState, type ForkSubmitOptions, ForkUI, type LoadManifestInput, type Manifest, type ManifestEntry, type ManifestModuleEntry, type QueryLlmJobsInput, type QueryValuesInput, type SelectedElementContext, type SetOptionsInput, type SetValuesInput, type UseForkFeatureValuesInput, type UseForkLlmJobsInput, clearCachedManifest, createForkDataClient, forkEntityValueKey, forkable, loadManifest, manifestDiffers, readCachedManifest, registerForkShared, useBoundaryFork, useFork, useForkChatPanel, useForkDataClient, useForkDataMutation, useForkFeatureValues, useForkLlmJobs, writeCachedManifest };

package/dist/index.d.ts

@@ -1,6 +1,50 @@
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import { ReactNode, ReactElement, ComponentType } from 'react';
 
+/**
+ * DOM element picker — the Chrome-DevTools-inspect experience for the chat
+ * panel. While active it paints a highlight overlay + label over whatever
+ * host-page element the cursor is on; clicking captures a structured context
+ * blob for the agent, Esc cancels.
+ *
+ * The overlay mounts directly on document.body (NOT inside the panel's
+ * shadow root) so it can sit over host elements, and it is pointer-events:
+ * none so document.elementFromPoint() resolves the real host target.
+ * Everything inside the Fork panel/launcher hosts is ignored — hovering the
+ * panel clears the highlight, clicking it neither selects nor cancels.
+ */
+interface SelectedElementContext {
+    tag: string;
+    id?: string;
+    classes?: string[];
+    selector?: string;
+    componentName?: string;
+    text?: string;
+    html?: string;
+    rect?: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+}
+
+/** Image attachment riding on a fork prompt (raw base64 + media type). */
+interface ForkPromptAttachment {
+    mediaType: string;
+    data: string;
+}
+/** Options for submitting a prompt from the chat panel. */
+interface ForkSubmitOptions {
+    /** Follow-up on this fork (otherwise a new fork is composed). */
+    forkId?: string | null;
+    /** Force a new fork even when one exists for the target. */
+    forceNew?: boolean;
+    /** Screenshots pasted/uploaded into the composer. */
+    attachments?: ForkPromptAttachment[];
+    /** DOM element the user picked on the page for context. */
+    selectedElement?: SelectedElementContext | null;
+}
 interface Fork {
     id: string;
     userId: string;
@@ -63,7 +107,8 @@ interface ForkProviderBase {
     shared?: ForkSharedRegistry;
 }
 /**
- * User identity — provide EITHER userId (optionally with userHash) OR authUrl:
+ * User identity — provide EITHER userId (optionally with userHash or userJwt)
+ * OR authUrl:
  *
  * - `userId` alone: Client-asserted, no server verification (dev/testing only).
  * - `userId` + `userHash`: Host-brokered verified identity. Your backend
@@ -71,12 +116,37 @@ interface ForkProviderBase {
  *   both as props. Fork never touches cookies or Web Storage for identity, so
  *   this is the required mode for embedded/iframe contexts where third-party
  *   cookies are blocked (e.g. app-store review environments).
- * - `authUrl`: URL on your backend that returns `{ userId, userHash }`.
- *   The SDK calls this on mount (same-origin, cookies sent automatically).
- *   Relies on the host's cookie session, so it does not work where the host
- *   page's cookies are third-party — prefer the userHash prop mode there.
+ * - `userJwt`: OPTIONAL and ADDITIVE — it carries custom user attributes, it
+ *   does not replace the identity you already send. Your backend signs HS256
+ *   with a key DERIVED from your sk_ — `HMAC-SHA256(sk_, "fork-user-jwt-v1")`,
+ *   never sk_ itself, which would let your own auth endpoint be used as a
+ *   signing oracle. Payload: `{ sub: userId, attrs: { role, vertical, ... } }`
+ *   with `audience: "fork"` and an `expiresIn` (both required, max 7 days).
+ *   Everything in `attrs` becomes a custom user attribute visible in Fork
+ *   admin. Because the claim sits inside the signature, an end user cannot
+ *   forge it from devtools — which is why attributes ride here and not in a
+ *   plain prop. Keep sending `userId` + `userHash` alongside it.
+ * - `authUrl`: URL on your backend that returns `{ userId, userHash }`, plus
+ *   `userJwt` if you want attributes. The SDK calls it on mount (same-origin,
+ *   cookies sent automatically). Relies on the host's cookie session, so it
+ *   does not work where the host page's cookies are third-party — prefer the
+ *   prop modes there.
+ *
+ * `userHash` remains the universal credential and is NOT deprecated: it is what
+ * authenticates every request the SDK makes. `userJwt` is stamped on the
+ * provider's own calls, which is where attributes get recorded — one such call
+ * per mount is all it takes, since the server leaves stored attributes untouched
+ * on requests that carry no token.
+ *
+ * Adding attributes to an existing integration is therefore purely additive:
+ * return one more field from the endpoint you already have. Nothing you send
+ * today changes meaning, and rolling it back is deleting that field.
  *
- * In either verified mode, if the user is also a Fork tenant operator (their
+ * Expiry is required and capped at 7 days; 24h is a reasonable choice. An
+ * expired token costs you attribute freshness, never access, because `userHash`
+ * is still carrying the identity.
+ *
+ * In any verified mode, if the user is also a Fork tenant operator (their
  * email matches a fork_users row with a user_roles entry on this tenant), the
  * SDK transparently enters admin mode and acts as their mapped end-user — set
  * the mapping in Fork's Team Settings → End user.
@@ -84,11 +154,13 @@ interface ForkProviderBase {
 type ForkProviderProps = ForkProviderBase & ({
     userId: string;
     userHash?: string;
+    userJwt?: string;
     authUrl?: never;
 } | {
     authUrl: string;
     userId?: never;
     userHash?: never;
+    userJwt?: never;
 });
 interface ForkBoundaryRegistration {
     id: string;
@@ -268,11 +340,8 @@ interface ForkPanelProps {
     targetId?: string;
     targetLabel?: string;
     historyMode?: "slot" | "boundary" | "none";
-    onSubmit: (prompt: string, targetId: string, containerId?: string | null, opts?: {
-        forkId?: string | null;
-        forceNew?: boolean;
-    }) => void;
-    onUndo?: (targetId: string) => Promise<any>;
+    onSubmit: (prompt: string, targetId: string, containerId?: string | null, opts?: ForkSubmitOptions) => void;
+    onUndo?: (targetId: string, forkId?: string | null) => Promise<any>;
     onClose: () => void;
     baseUrl?: string;
     apiKey?: string;
@@ -302,10 +371,7 @@ declare function useFork(): {
     runs: Record<string, ForkRun>;
     open: () => void;
     close: () => void;
-    startFork: (prompt: string, slotId?: string, containerId?: string | null, opts?: {
-        forkId?: string | null;
-        forceNew?: boolean;
-    }) => Promise<void>;
+    startFork: (prompt: string, slotId?: string, containerId?: string | null, opts?: ForkSubmitOptions) => Promise<void>;
     undoFork: (slotId: string) => Promise<any>;
     adoptRunningFork: (forkId: string) => Promise<void>;
 };
@@ -318,11 +384,8 @@ declare function useBoundaryFork(boundaryId: string): {
     runs: Record<string, ForkRun>;
     open: () => void;
     close: () => void;
-    startFork: (prompt: string, containerId?: string | null, opts?: {
-        forkId?: string | null;
-        forceNew?: boolean;
-    }) => Promise<void>;
-    undoFork: () => Promise<any>;
+    startFork: (prompt: string, containerId?: string | null, opts?: ForkSubmitOptions) => Promise<void>;
+    undoFork: (forkId?: string | null) => Promise<any>;
     adoptRunningFork: (forkId: string) => Promise<void>;
 };
 
@@ -332,22 +395,16 @@ declare function useForkChatPanel(options: ForkChatPanelOptions): {
     targetId: string;
     targetLabel: string | undefined;
     historyMode: "slot" | "boundary";
-    submit: (prompt: string, submittedTargetId?: string, containerId?: string | null, opts?: {
-        forkId?: string | null;
-        forceNew?: boolean;
-    }) => Promise<void>;
-    undo: (submittedTargetId?: string) => Promise<any>;
+    submit: (prompt: string, submittedTargetId?: string, containerId?: string | null, opts?: ForkSubmitOptions) => Promise<void>;
+    undo: (submittedTargetId?: string, forkId?: string | null) => Promise<any>;
     buttonProps: {
         onClick: () => void;
         hasNotification: boolean;
         activity: ForkActivitySummary;
     };
     panelProps: {
-        onSubmit: (prompt: string, submittedTargetId?: string, containerId?: string | null, opts?: {
-            forkId?: string | null;
-            forceNew?: boolean;
-        }) => Promise<void>;
-        onUndo: (submittedTargetId?: string) => Promise<any>;
+        onSubmit: (prompt: string, submittedTargetId?: string, containerId?: string | null, opts?: ForkSubmitOptions) => Promise<void>;
+        onUndo: (submittedTargetId?: string, forkId?: string | null) => Promise<any>;
         onClose: (() => void) | (() => void);
         baseUrl: string;
         apiKey: string;
@@ -363,11 +420,8 @@ declare function useForkChatPanel(options: ForkChatPanelOptions): {
         error: string | null;
         runs: Record<string, ForkRun>;
     } | {
-        onSubmit: (prompt: string, submittedTargetId?: string, containerId?: string | null, opts?: {
-            forkId?: string | null;
-            forceNew?: boolean;
-        }) => Promise<void>;
-        onUndo: (submittedTargetId?: string) => Promise<any>;
+        onSubmit: (prompt: string, submittedTargetId?: string, containerId?: string | null, opts?: ForkSubmitOptions) => Promise<void>;
+        onUndo: (submittedTargetId?: string, forkId?: string | null) => Promise<any>;
         onClose: (() => void) | (() => void);
         baseUrl: string;
         apiKey: string;
@@ -397,22 +451,16 @@ declare function useForkChatPanel(options: ForkChatPanelOptions): {
     targetId: string;
     targetLabel: string | undefined;
     historyMode: "slot" | "boundary";
-    submit: (prompt: string, submittedTargetId?: string, containerId?: string | null, opts?: {
-        forkId?: string | null;
-        forceNew?: boolean;
-    }) => Promise<void>;
-    undo: (submittedTargetId?: string) => Promise<any>;
+    submit: (prompt: string, submittedTargetId?: string, containerId?: string | null, opts?: ForkSubmitOptions) => Promise<void>;
+    undo: (submittedTargetId?: string, forkId?: string | null) => Promise<any>;
     buttonProps: {
         onClick: () => void;
         hasNotification: boolean;
         activity: ForkActivitySummary;
     };
     panelProps: {
-        onSubmit: (prompt: string, submittedTargetId?: string, containerId?: string | null, opts?: {
-            forkId?: string | null;
-            forceNew?: boolean;
-        }) => Promise<void>;
-        onUndo: (submittedTargetId?: string) => Promise<any>;
+        onSubmit: (prompt: string, submittedTargetId?: string, containerId?: string | null, opts?: ForkSubmitOptions) => Promise<void>;
+        onUndo: (submittedTargetId?: string, forkId?: string | null) => Promise<any>;
         onClose: (() => void) | (() => void);
         baseUrl: string;
         apiKey: string;
@@ -428,11 +476,8 @@ declare function useForkChatPanel(options: ForkChatPanelOptions): {
         error: string | null;
         runs: Record<string, ForkRun>;
     } | {
-        onSubmit: (prompt: string, submittedTargetId?: string, containerId?: string | null, opts?: {
-            forkId?: string | null;
-            forceNew?: boolean;
-        }) => Promise<void>;
-        onUndo: (submittedTargetId?: string) => Promise<any>;
+        onSubmit: (prompt: string, submittedTargetId?: string, containerId?: string | null, opts?: ForkSubmitOptions) => Promise<void>;
+        onUndo: (submittedTargetId?: string, forkId?: string | null) => Promise<any>;
         onClose: (() => void) | (() => void);
         baseUrl: string;
         apiKey: string;
@@ -791,6 +836,12 @@ interface LoadManifestInput {
     userId: string;
     /** Optional userHash for HMAC verification. */
     userHash?: string;
+    /**
+     * Optional attribute-bearing token (see ForkProviderProps). Sent so the
+     * manifest fetch — which runs on every mount, for every user, not just
+     * operators — is what records the tenant's custom user attributes.
+     */
+    userJwt?: string;
     /** Authorized explicit container lookup, used for container-bound previews. */
     containerId?: string;
     /** Additional trusted headers, e.g. preview session headers. */
@@ -817,4 +868,4 @@ declare function clearCachedManifest(tenantId: string, appId: string, userId: st
  */
 declare function manifestDiffers(a: Manifest | null, b: Manifest | null): boolean;
 
-export { type AdminContainer, type AdminContext, type EnsureFeatureInput, type EnsureLlmJobsInput, type Fork, type ForkActivity, type ForkActivitySummary, type ForkActivityTargetKind, type ForkBoundaryDefinition, ForkBoundaryUI, ForkButton, ForkChatInterface, type ForkChatInterfaceProps, type ForkChatPanelOptions, type ForkChatTarget, type ForkDataClient, type ForkDataClientConfig, type ForkDataSource, type ForkDataStatus, type ForkEntityRef, type ForkEvent, type ForkFeature, type ForkFeatureKind, type ForkFeatureOption, type ForkFeatureValue, type ForkLlmJob, type ForkLlmJobStatus, ForkPanel, ForkProvider, type ForkProviderProps, type ForkSharedRegistry, ForkSlot, type ForkSlotProps, type ForkState, ForkUI, type LoadManifestInput, type Manifest, type ManifestEntry, type ManifestModuleEntry, type QueryLlmJobsInput, type QueryValuesInput, type SetOptionsInput, type SetValuesInput, type UseForkFeatureValuesInput, type UseForkLlmJobsInput, clearCachedManifest, createForkDataClient, forkEntityValueKey, forkable, loadManifest, manifestDiffers, readCachedManifest, registerForkShared, useBoundaryFork, useFork, useForkChatPanel, useForkDataClient, useForkDataMutation, useForkFeatureValues, useForkLlmJobs, writeCachedManifest };
+export { type AdminContainer, type AdminContext, type EnsureFeatureInput, type EnsureLlmJobsInput, type Fork, type ForkActivity, type ForkActivitySummary, type ForkActivityTargetKind, type ForkBoundaryDefinition, ForkBoundaryUI, ForkButton, ForkChatInterface, type ForkChatInterfaceProps, type ForkChatPanelOptions, type ForkChatTarget, type ForkDataClient, type ForkDataClientConfig, type ForkDataSource, type ForkDataStatus, type ForkEntityRef, type ForkEvent, type ForkFeature, type ForkFeatureKind, type ForkFeatureOption, type ForkFeatureValue, type ForkLlmJob, type ForkLlmJobStatus, ForkPanel, type ForkPromptAttachment, ForkProvider, type ForkProviderProps, type ForkSharedRegistry, ForkSlot, type ForkSlotProps, type ForkState, type ForkSubmitOptions, ForkUI, type LoadManifestInput, type Manifest, type ManifestEntry, type ManifestModuleEntry, type QueryLlmJobsInput, type QueryValuesInput, type SelectedElementContext, type SetOptionsInput, type SetValuesInput, type UseForkFeatureValuesInput, type UseForkLlmJobsInput, clearCachedManifest, createForkDataClient, forkEntityValueKey, forkable, loadManifest, manifestDiffers, readCachedManifest, registerForkShared, useBoundaryFork, useFork, useForkChatPanel, useForkDataClient, useForkDataMutation, useForkFeatureValues, useForkLlmJobs, writeCachedManifest };