lemma-sdk 0.2.43 → 0.2.45

package/dist/openapi_client/services/UsageService.js

@@ -0,0 +1,210 @@
+import { OpenAPI } from '../core/OpenAPI.js';
+import { request as __request } from '../core/request.js';
+export class UsageService {
+    /**
+     * List Usage Events
+     * @param organizationId
+     * @param start
+     * @param end
+     * @param days
+     * @param limit
+     * @param podId
+     * @param userId
+     * @param agentId
+     * @param profileId
+     * @param profileScope
+     * @param modelName
+     * @param usageKind
+     * @param sourceType
+     * @param status
+     * @returns UsageListResponse Successful Response
+     * @throws ApiError
+     */
+    static usageOrganizationEventsList(organizationId, start, end, days = 30, limit = 100, podId, userId, agentId, profileId, profileScope, modelName, usageKind, sourceType, status) {
+        return __request(OpenAPI, {
+            method: 'GET',
+            url: '/usage/organizations/{organization_id}/events',
+            path: {
+                'organization_id': organizationId,
+            },
+            query: {
+                'start': start,
+                'end': end,
+                'days': days,
+                'limit': limit,
+                'pod_id': podId,
+                'user_id': userId,
+                'agent_id': agentId,
+                'profile_id': profileId,
+                'profile_scope': profileScope,
+                'model_name': modelName,
+                'usage_kind': usageKind,
+                'source_type': sourceType,
+                'status': status,
+            },
+            errors: {
+                422: `Validation Error`,
+            },
+        });
+    }
+    /**
+     * Get Usage Limits
+     * @param organizationId
+     * @returns UsageLimitsResponse Successful Response
+     * @throws ApiError
+     */
+    static usageOrganizationLimitsGet(organizationId) {
+        return __request(OpenAPI, {
+            method: 'GET',
+            url: '/usage/organizations/{organization_id}/limits',
+            path: {
+                'organization_id': organizationId,
+            },
+            errors: {
+                422: `Validation Error`,
+            },
+        });
+    }
+    /**
+     * Get My Usage
+     * @param organizationId
+     * @param start
+     * @param end
+     * @param days
+     * @param limit
+     * @param podId
+     * @param userId
+     * @param agentId
+     * @param profileId
+     * @param profileScope
+     * @param modelName
+     * @param usageKind
+     * @param sourceType
+     * @param status
+     * @returns UsageSummaryResponse Successful Response
+     * @throws ApiError
+     */
+    static usageOrganizationMeSummaryGet(organizationId, start, end, days = 30, limit = 100, podId, userId, agentId, profileId, profileScope, modelName, usageKind, sourceType, status) {
+        return __request(OpenAPI, {
+            method: 'GET',
+            url: '/usage/organizations/{organization_id}/me',
+            path: {
+                'organization_id': organizationId,
+            },
+            query: {
+                'start': start,
+                'end': end,
+                'days': days,
+                'limit': limit,
+                'pod_id': podId,
+                'user_id': userId,
+                'agent_id': agentId,
+                'profile_id': profileId,
+                'profile_scope': profileScope,
+                'model_name': modelName,
+                'usage_kind': usageKind,
+                'source_type': sourceType,
+                'status': status,
+            },
+            errors: {
+                422: `Validation Error`,
+            },
+        });
+    }
+    /**
+     * Get Usage Stats
+     * @param organizationId
+     * @param start
+     * @param end
+     * @param days
+     * @param limit
+     * @param podId
+     * @param userId
+     * @param agentId
+     * @param profileId
+     * @param profileScope
+     * @param modelName
+     * @param usageKind
+     * @param sourceType
+     * @param status
+     * @param granularity
+     * @param groupBy
+     * @returns UsageStatsResponse Successful Response
+     * @throws ApiError
+     */
+    static usageOrganizationStatsGet(organizationId, start, end, days = 30, limit = 100, podId, userId, agentId, profileId, profileScope, modelName, usageKind, sourceType, status, granularity = 'day', groupBy) {
+        return __request(OpenAPI, {
+            method: 'GET',
+            url: '/usage/organizations/{organization_id}/stats',
+            path: {
+                'organization_id': organizationId,
+            },
+            query: {
+                'start': start,
+                'end': end,
+                'days': days,
+                'limit': limit,
+                'pod_id': podId,
+                'user_id': userId,
+                'agent_id': agentId,
+                'profile_id': profileId,
+                'profile_scope': profileScope,
+                'model_name': modelName,
+                'usage_kind': usageKind,
+                'source_type': sourceType,
+                'status': status,
+                'granularity': granularity,
+                'group_by': groupBy,
+            },
+            errors: {
+                422: `Validation Error`,
+            },
+        });
+    }
+    /**
+     * Get Organization Usage Summary
+     * @param organizationId
+     * @param start
+     * @param end
+     * @param days
+     * @param limit
+     * @param podId
+     * @param userId
+     * @param agentId
+     * @param profileId
+     * @param profileScope
+     * @param modelName
+     * @param usageKind
+     * @param sourceType
+     * @param status
+     * @returns UsageSummaryResponse Successful Response
+     * @throws ApiError
+     */
+    static usageOrganizationSummaryGet(organizationId, start, end, days = 30, limit = 100, podId, userId, agentId, profileId, profileScope, modelName, usageKind, sourceType, status) {
+        return __request(OpenAPI, {
+            method: 'GET',
+            url: '/usage/organizations/{organization_id}/summary',
+            path: {
+                'organization_id': organizationId,
+            },
+            query: {
+                'start': start,
+                'end': end,
+                'days': days,
+                'limit': limit,
+                'pod_id': podId,
+                'user_id': userId,
+                'agent_id': agentId,
+                'profile_id': profileId,
+                'profile_scope': profileScope,
+                'model_name': modelName,
+                'usage_kind': usageKind,
+                'source_type': sourceType,
+                'status': status,
+            },
+            errors: {
+                422: `Validation Error`,
+            },
+        });
+    }
+}

package/dist/openapi_client/services/WorkflowsService.d.ts

@@ -1,16 +1,17 @@
-import type { FlowResponse } from '../models/FlowResponse.js';
-import type { FlowRunEntity } from '../models/FlowRunEntity.js';
+import type { FlowDetailResponse } from '../models/FlowDetailResponse.js';
 import type { WorkflowCreateRequest } from '../models/WorkflowCreateRequest.js';
 import type { WorkflowGraphUpdateRequest } from '../models/WorkflowGraphUpdateRequest.js';
 import type { WorkflowListResponse } from '../models/WorkflowListResponse.js';
+import type { WorkflowRunFormSubmitRequest } from '../models/WorkflowRunFormSubmitRequest.js';
 import type { WorkflowRunListResponse } from '../models/WorkflowRunListResponse.js';
+import type { WorkflowRunResponse } from '../models/WorkflowRunResponse.js';
 import type { WorkflowRunWaitAssignmentListResponse } from '../models/WorkflowRunWaitAssignmentListResponse.js';
 import type { WorkflowUpdateRequest } from '../models/WorkflowUpdateRequest.js';
 import type { CancelablePromise } from '../core/CancelablePromise.js';
 export declare class WorkflowsService {
     /**
      * List Workflow Runs Waiting For Current User
-     * List active human form waits assigned to the current pod member.
+     * The current user's approval queue: active form waits assigned to them, with the owning run.
      * @param podId
      * @param limit
      * @param pageToken
@@ -20,23 +21,32 @@ export declare class WorkflowsService {
     static workflowRunWaitingAssignedToMe(podId: string, limit?: number, pageToken?: (string | null)): CancelablePromise<WorkflowRunWaitAssignmentListResponse>;
     /**
      * Get Workflow Run
-     * Get current state, context, and step history of a workflow run.
+     * Get current state, context, step history, and the active wait (when WAITING) of a workflow run.
      * @param podId
      * @param runId
-     * @returns FlowRunEntity Successful Response
+     * @returns WorkflowRunResponse Successful Response
      * @throws ApiError
      */
-    static workflowRunGet(podId: string, runId: string): CancelablePromise<FlowRunEntity>;
+    static workflowRunGet(podId: string, runId: string): CancelablePromise<WorkflowRunResponse>;
     /**
-     * Resume Workflow Run
-     * Resume a run in WAITING or EXECUTING state. The payload is written back into the current waiting node output and execution continues.
+     * Cancel Workflow Run
+     * Cancel a non-terminal run. The active wait (if any) is cancelled in the same transaction; late completion events for cancelled waits are dropped. Cancelling a terminal run returns 409.
+     * @param podId
+     * @param runId
+     * @returns WorkflowRunResponse Successful Response
+     * @throws ApiError
+     */
+    static workflowRunCancel(podId: string, runId: string): CancelablePromise<WorkflowRunResponse>;
+    /**
+     * Submit Workflow Run Form
+     * Submit the form the run is waiting on. `node_id` must match the run's active HUMAN wait (409 when the run is not waiting on a form, 422 on node mismatch, 403 when the wait is assigned to someone else). The submitted `inputs` become the form node's output, available to later nodes as `<node_id>.<field>`.
      * @param podId
      * @param runId
      * @param requestBody
-     * @returns FlowRunEntity Successful Response
+     * @returns WorkflowRunResponse Successful Response
      * @throws ApiError
      */
-    static workflowRunResume(podId: string, runId: string, requestBody: Record<string, any>): CancelablePromise<FlowRunEntity>;
+    static workflowRunFormSubmit(podId: string, runId: string, requestBody: WorkflowRunFormSubmitRequest): CancelablePromise<WorkflowRunResponse>;
     /**
      * Visualize Workflow Run
      * Render an HTML view of a run overlaid on its workflow graph.
@@ -46,17 +56,6 @@ export declare class WorkflowsService {
      * @throws ApiError
      */
     static workflowRunVisualize(podId: string, runId: string): CancelablePromise<string>;
-    /**
-     * List Workflow Runs
-     * List recent runs for a given workflow.
-     * @param podId
-     * @param workflowName
-     * @param limit
-     * @param pageToken
-     * @returns WorkflowRunListResponse Successful Response
-     * @throws ApiError
-     */
-    static workflowRunList(podId: string, workflowName: string, limit?: number, pageToken?: (string | null)): CancelablePromise<WorkflowRunListResponse>;
     /**
      * List Workflows
      * List all workflows in a pod.
@@ -69,13 +68,13 @@ export declare class WorkflowsService {
     static workflowList(podId: string, limit?: number, pageToken?: (string | null)): CancelablePromise<WorkflowListResponse>;
     /**
      * Create Workflow
-     * Create a workflow definition. Use this before uploading graph nodes/edges with `workflow.graph.update`.
+     * Create a workflow definition. The graph (`nodes`/`edges`) can be included in this call to create a ready-to-run workflow in one step, or omitted to create a shell and upload the graph later with `workflow.graph.update`.
      * @param podId
      * @param requestBody
-     * @returns FlowResponse Successful Response
+     * @returns FlowDetailResponse Successful Response
      * @throws ApiError
      */
-    static workflowCreate(podId: string, requestBody: WorkflowCreateRequest): CancelablePromise<FlowResponse>;
+    static workflowCreate(podId: string, requestBody: WorkflowCreateRequest): CancelablePromise<FlowDetailResponse>;
     /**
      * Delete Workflow
      * Delete a workflow definition.
@@ -90,40 +89,50 @@ export declare class WorkflowsService {
      * Get a single workflow definition including graph and start configuration.
      * @param podId
      * @param workflowName
-     * @returns FlowResponse Successful Response
+     * @returns FlowDetailResponse Successful Response
      * @throws ApiError
      */
-    static workflowGet(podId: string, workflowName: string): CancelablePromise<FlowResponse>;
+    static workflowGet(podId: string, workflowName: string): CancelablePromise<FlowDetailResponse>;
     /**
      * Update Workflow Metadata
      * Update workflow-level metadata such as description and schedule mode. Workflow names are immutable after creation. Use `workflow.graph.update` for nodes and edges.
      * @param podId
      * @param workflowName
      * @param requestBody
-     * @returns FlowResponse Successful Response
+     * @returns FlowDetailResponse Successful Response
      * @throws ApiError
      */
-    static workflowUpdate(podId: string, workflowName: string, requestBody: WorkflowUpdateRequest): CancelablePromise<FlowResponse>;
+    static workflowUpdate(podId: string, workflowName: string, requestBody: WorkflowUpdateRequest): CancelablePromise<FlowDetailResponse>;
     /**
      * Update Workflow Graph
      * Replace the workflow graph. Agent/function node `input_mapping` entries must use explicit typed bindings. Use `{type: "expression", value: "start.payload.issue.key"}` for context lookups and `{type: "literal", value: "abc"}` for fixed JSON values.
      * @param podId
      * @param workflowName
      * @param requestBody
-     * @returns FlowResponse Successful Response
+     * @returns FlowDetailResponse Successful Response
      * @throws ApiError
      */
-    static workflowGraphUpdate(podId: string, workflowName: string, requestBody: WorkflowGraphUpdateRequest): CancelablePromise<FlowResponse>;
+    static workflowGraphUpdate(podId: string, workflowName: string, requestBody: WorkflowGraphUpdateRequest): CancelablePromise<FlowDetailResponse>;
     /**
-     * Start Workflow
-     * Start a new workflow run. For event/scheduled/datastore starts, the request body is treated as initial trigger payload and merged into execution context.
+     * List Workflow Runs
+     * List recent runs for a given workflow.
      * @param podId
      * @param workflowName
-     * @param requestBody
-     * @returns FlowRunEntity Successful Response
+     * @param limit
+     * @param pageToken
+     * @returns WorkflowRunListResponse Successful Response
+     * @throws ApiError
+     */
+    static workflowRunList(podId: string, workflowName: string, limit?: number, pageToken?: (string | null)): CancelablePromise<WorkflowRunListResponse>;
+    /**
+     * Create Workflow Run
+     * Create a new run for this workflow. Takes no request body: if the workflow's entry node is a FORM node the run is created WAITING on it (see `active_wait` in the response) and input is submitted via `workflow.run.form.submit`; otherwise the run executes immediately. Trigger payloads for scheduled/event/datastore starts are supplied by the platform, not through this endpoint.
+     * @param podId
+     * @param workflowName
+     * @returns WorkflowRunResponse Successful Response
      * @throws ApiError
      */
-    static workflowStart(podId: string, workflowName: string, requestBody: Record<string, any>): CancelablePromise<FlowRunEntity>;
+    static workflowRunCreate(podId: string, workflowName: string): CancelablePromise<WorkflowRunResponse>;
     /**
      * Visualize Workflow
      * Render an HTML visualization for debugging workflow graph structure.

package/dist/openapi_client/services/WorkflowsService.js

@@ -3,7 +3,7 @@ import { request as __request } from '../core/request.js';
 export class WorkflowsService {
     /**
      * List Workflow Runs Waiting For Current User
-     * List active human form waits assigned to the current pod member.
+     * The current user's approval queue: active form waits assigned to them, with the owning run.
      * @param podId
      * @param limit
      * @param pageToken
@@ -28,10 +28,10 @@ export class WorkflowsService {
     }
     /**
      * Get Workflow Run
-     * Get current state, context, and step history of a workflow run.
+     * Get current state, context, step history, and the active wait (when WAITING) of a workflow run.
      * @param podId
      * @param runId
-     * @returns FlowRunEntity Successful Response
+     * @returns WorkflowRunResponse Successful Response
      * @throws ApiError
      */
     static workflowRunGet(podId, runId) {
@@ -48,71 +48,65 @@ export class WorkflowsService {
         });
     }
     /**
-     * Resume Workflow Run
-     * Resume a run in WAITING or EXECUTING state. The payload is written back into the current waiting node output and execution continues.
+     * Cancel Workflow Run
+     * Cancel a non-terminal run. The active wait (if any) is cancelled in the same transaction; late completion events for cancelled waits are dropped. Cancelling a terminal run returns 409.
      * @param podId
      * @param runId
-     * @param requestBody
-     * @returns FlowRunEntity Successful Response
+     * @returns WorkflowRunResponse Successful Response
      * @throws ApiError
      */
-    static workflowRunResume(podId, runId, requestBody) {
+    static workflowRunCancel(podId, runId) {
         return __request(OpenAPI, {
             method: 'POST',
-            url: '/pods/{pod_id}/workflow-runs/{run_id}/resume',
+            url: '/pods/{pod_id}/workflow-runs/{run_id}/cancel',
             path: {
                 'pod_id': podId,
                 'run_id': runId,
             },
-            body: requestBody,
-            mediaType: 'application/json',
             errors: {
                 422: `Validation Error`,
             },
         });
     }
     /**
-     * Visualize Workflow Run
-     * Render an HTML view of a run overlaid on its workflow graph.
+     * Submit Workflow Run Form
+     * Submit the form the run is waiting on. `node_id` must match the run's active HUMAN wait (409 when the run is not waiting on a form, 422 on node mismatch, 403 when the wait is assigned to someone else). The submitted `inputs` become the form node's output, available to later nodes as `<node_id>.<field>`.
      * @param podId
      * @param runId
-     * @returns string Successful Response
+     * @param requestBody
+     * @returns WorkflowRunResponse Successful Response
      * @throws ApiError
      */
-    static workflowRunVisualize(podId, runId) {
+    static workflowRunFormSubmit(podId, runId, requestBody) {
         return __request(OpenAPI, {
-            method: 'GET',
-            url: '/pods/{pod_id}/workflow-runs/{run_id}/visualize',
+            method: 'POST',
+            url: '/pods/{pod_id}/workflow-runs/{run_id}/form',
             path: {
                 'pod_id': podId,
                 'run_id': runId,
             },
+            body: requestBody,
+            mediaType: 'application/json',
             errors: {
                 422: `Validation Error`,
             },
         });
     }
     /**
-     * List Workflow Runs
-     * List recent runs for a given workflow.
+     * Visualize Workflow Run
+     * Render an HTML view of a run overlaid on its workflow graph.
      * @param podId
-     * @param workflowName
-     * @param limit
-     * @param pageToken
-     * @returns WorkflowRunListResponse Successful Response
+     * @param runId
+     * @returns string Successful Response
      * @throws ApiError
      */
-    static workflowRunList(podId, workflowName, limit = 100, pageToken) {
+    static workflowRunVisualize(podId, runId) {
         return __request(OpenAPI, {
             method: 'GET',
-            url: '/pods/{pod_id}/workflow-runs/{workflow_name}/runs',
+            url: '/pods/{pod_id}/workflow-runs/{run_id}/visualize',
             path: {
                 'pod_id': podId,
-                'workflow_name': workflowName,
-            },
-            query: {
-                'limit': limit,
-                'page_token': pageToken,
+                'run_id': runId,
             },
             errors: {
                 422: `Validation Error`,
@@ -146,10 +140,10 @@ export class WorkflowsService {
     }
     /**
      * Create Workflow
-     * Create a workflow definition. Use this before uploading graph nodes/edges with `workflow.graph.update`.
+     * Create a workflow definition. The graph (`nodes`/`edges`) can be included in this call to create a ready-to-run workflow in one step, or omitted to create a shell and upload the graph later with `workflow.graph.update`.
      * @param podId
      * @param requestBody
-     * @returns FlowResponse Successful Response
+     * @returns FlowDetailResponse Successful Response
      * @throws ApiError
      */
     static workflowCreate(podId, requestBody) {
@@ -192,7 +186,7 @@ export class WorkflowsService {
      * Get a single workflow definition including graph and start configuration.
      * @param podId
      * @param workflowName
-     * @returns FlowResponse Successful Response
+     * @returns FlowDetailResponse Successful Response
      * @throws ApiError
      */
     static workflowGet(podId, workflowName) {
@@ -214,7 +208,7 @@ export class WorkflowsService {
      * @param podId
      * @param workflowName
      * @param requestBody
-     * @returns FlowResponse Successful Response
+     * @returns FlowDetailResponse Successful Response
      * @throws ApiError
      */
     static workflowUpdate(podId, workflowName, requestBody) {
@@ -238,7 +232,7 @@ export class WorkflowsService {
      * @param podId
      * @param workflowName
      * @param requestBody
-     * @returns FlowResponse Successful Response
+     * @returns FlowDetailResponse Successful Response
      * @throws ApiError
      */
     static workflowGraphUpdate(podId, workflowName, requestBody) {
@@ -257,24 +251,48 @@ export class WorkflowsService {
         });
     }
     /**
-     * Start Workflow
-     * Start a new workflow run. For event/scheduled/datastore starts, the request body is treated as initial trigger payload and merged into execution context.
+     * List Workflow Runs
+     * List recent runs for a given workflow.
      * @param podId
      * @param workflowName
-     * @param requestBody
-     * @returns FlowRunEntity Successful Response
+     * @param limit
+     * @param pageToken
+     * @returns WorkflowRunListResponse Successful Response
+     * @throws ApiError
+     */
+    static workflowRunList(podId, workflowName, limit = 100, pageToken) {
+        return __request(OpenAPI, {
+            method: 'GET',
+            url: '/pods/{pod_id}/workflows/{workflow_name}/runs',
+            path: {
+                'pod_id': podId,
+                'workflow_name': workflowName,
+            },
+            query: {
+                'limit': limit,
+                'page_token': pageToken,
+            },
+            errors: {
+                422: `Validation Error`,
+            },
+        });
+    }
+    /**
+     * Create Workflow Run
+     * Create a new run for this workflow. Takes no request body: if the workflow's entry node is a FORM node the run is created WAITING on it (see `active_wait` in the response) and input is submitted via `workflow.run.form.submit`; otherwise the run executes immediately. Trigger payloads for scheduled/event/datastore starts are supplied by the platform, not through this endpoint.
+     * @param podId
+     * @param workflowName
+     * @returns WorkflowRunResponse Successful Response
      * @throws ApiError
      */
-    static workflowStart(podId, workflowName, requestBody) {
+    static workflowRunCreate(podId, workflowName) {
         return __request(OpenAPI, {
             method: 'POST',
-            url: '/pods/{pod_id}/workflows/{workflow_name}/start',
+            url: '/pods/{pod_id}/workflows/{workflow_name}/runs',
             path: {
                 'pod_id': podId,
                 'workflow_name': workflowName,
             },
-            body: requestBody,
-            mediaType: 'application/json',
             errors: {
                 422: `Validation Error`,
             },

package/dist/openapi_client/services/WorkspaceAppsService.d.ts

@@ -0,0 +1,12 @@
+import type { WorkspaceAppAccessRequest } from '../models/WorkspaceAppAccessRequest.js';
+import type { WorkspaceAppAccessResponse } from '../models/WorkspaceAppAccessResponse.js';
+import type { CancelablePromise } from '../core/CancelablePromise.js';
+export declare class WorkspaceAppsService {
+    /**
+     * Create workspace browser access URL
+     * @param requestBody
+     * @returns WorkspaceAppAccessResponse Successful Response
+     * @throws ApiError
+     */
+    static workspaceBrowserAccess(requestBody: WorkspaceAppAccessRequest): CancelablePromise<WorkspaceAppAccessResponse>;
+}

package/dist/openapi_client/services/WorkspaceAppsService.js

@@ -0,0 +1,21 @@
+import { OpenAPI } from '../core/OpenAPI.js';
+import { request as __request } from '../core/request.js';
+export class WorkspaceAppsService {
+    /**
+     * Create workspace browser access URL
+     * @param requestBody
+     * @returns WorkspaceAppAccessResponse Successful Response
+     * @throws ApiError
+     */
+    static workspaceBrowserAccess(requestBody) {
+        return __request(OpenAPI, {
+            method: 'POST',
+            url: '/workspace/apps/browser/access',
+            body: requestBody,
+            mediaType: 'application/json',
+            errors: {
+                422: `Validation Error`,
+            },
+        });
+    }
+}

package/dist/openapi_client/services/WorkspaceService.d.ts

@@ -0,0 +1,10 @@
+import type { WorkspaceMeResponse } from '../models/WorkspaceMeResponse.js';
+import type { CancelablePromise } from '../core/CancelablePromise.js';
+export declare class WorkspaceService {
+    /**
+     * Get current workspace state
+     * @returns WorkspaceMeResponse Successful Response
+     * @throws ApiError
+     */
+    static workspaceMe(): CancelablePromise<WorkspaceMeResponse>;
+}

package/dist/openapi_client/services/WorkspaceService.js

@@ -0,0 +1,15 @@
+import { OpenAPI } from '../core/OpenAPI.js';
+import { request as __request } from '../core/request.js';
+export class WorkspaceService {
+    /**
+     * Get current workspace state
+     * @returns WorkspaceMeResponse Successful Response
+     * @throws ApiError
+     */
+    static workspaceMe() {
+        return __request(OpenAPI, {
+            method: 'GET',
+            url: '/workspace/me',
+        });
+    }
+}

package/dist/react/AuthGuard.d.ts

@@ -3,9 +3,23 @@ import type { LemmaClient } from "../client.js";
 export interface AuthGuardProps {
     client: LemmaClient;
     children: ReactNode;
-    appName?: string;
+    /** Optional custom loading element. Defaults to a blank screen. */
     loadingFallback?: ReactNode;
+    /** Optional custom unauthenticated element. Defaults to a centered sign-in page. */
     unauthenticatedFallback?: ReactNode;
+    /** Optional custom element shown when user is authenticated but lacks pod membership. */
     accessRequestFallback?: ReactNode;
 }
-export declare function AuthGuard({ client, children, appName, loadingFallback, unauthenticatedFallback, accessRequestFallback, }: AuthGuardProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * AuthGuard wraps your application and handles auth state:
+ * - Loading: shows loadingFallback (blank by default)
+ * - Unauthenticated: shows sign-in page (or custom unauthenticatedFallback)
+ * - Authenticated and member: renders children
+ * - Authenticated but not pod member: shows request-access page
+ *
+ * Usage:
+ *   <AuthGuard client={getClient()}>
+ *     <App />
+ *   </AuthGuard>
+ */
+export declare function AuthGuard({ client, children, loadingFallback, unauthenticatedFallback, accessRequestFallback, }: AuthGuardProps): import("react/jsx-runtime").JSX.Element;