@smartspace/api-client 0.1.0-pr.973.b9f6d9f → 0.1.0-pr.976.ba8c32f

package/dist/generated/chat/api.d.ts

@@ -10,6 +10,7 @@ export declare const getSmartSpaceChatAPI: () => {
     filesGetFileInfo: (id: string, params?: FilesGetFileInfoParams) => Promise<import("axios").AxiosResponse<FilesFile, any, {}>>;
     filesDownloadFile: (id: string, params?: FilesDownloadFileParams) => Promise<import("axios").AxiosResponse<unknown, any, {}>>;
     filesGetUri: (id: string, params?: FilesGetUriParams) => Promise<import("axios").AxiosResponse<FilesFileUriResponse, any, {}>>;
+    flowRunsCancelFlowRun: (id: string) => Promise<import("axios").AxiosResponse<void, any, {}>>;
     flowRunsGetVariables: (id: string) => Promise<import("axios").AxiosResponse<FlowRunsGetVariables200One | FlowRunsGetVariables200Three | FlowRunsGetVariables200Two, any, {}>>;
     flowRunsSetVariable: (id: string, variableName: string, flowRunsSetVariableBody: unknown) => Promise<import("axios").AxiosResponse<void, any, {}>>;
     messageThreadsThreadId: (id: string) => Promise<import("axios").AxiosResponse<void, any, {}>>;
@@ -51,6 +52,7 @@ export type FilesUploadFilesResult = NonNullable<Awaited<ReturnType<ReturnType<t
 export type FilesGetFileInfoResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getSmartSpaceChatAPI>['filesGetFileInfo']>>>;
 export type FilesDownloadFileResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getSmartSpaceChatAPI>['filesDownloadFile']>>>;
 export type FilesGetUriResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getSmartSpaceChatAPI>['filesGetUri']>>>;
+export type FlowRunsCancelFlowRunResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getSmartSpaceChatAPI>['flowRunsCancelFlowRun']>>>;
 export type FlowRunsGetVariablesResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getSmartSpaceChatAPI>['flowRunsGetVariables']>>>;
 export type FlowRunsSetVariableResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getSmartSpaceChatAPI>['flowRunsSetVariable']>>>;
 export type MessageThreadsThreadIdResult = NonNullable<Awaited<ReturnType<ReturnType<typeof getSmartSpaceChatAPI>['messageThreadsThreadId']>>>;

package/dist/generated/chat/api.js

@@ -58,6 +58,15 @@ const getSmartSpaceChatAPI = () => {
             params
         });
     };
+    /**
+     * @summary Requests cancellation of a queued or running flow run (the chat
+    thread id is the flow run id). Cancellation is cooperative: the
+    engine stops between block executions, typically within seconds.
+     */
+    const flowRunsCancelFlowRun = (id) => {
+        return (0, instance_1.customInstance)({ url: `/FlowRuns/${id}/cancel`, method: 'POST'
+        });
+    };
     const flowRunsGetVariables = (id) => {
         return (0, instance_1.customInstance)({ url: `/FlowRuns/${id}/variables`, method: 'GET'
         });
@@ -347,6 +356,6 @@ const getSmartSpaceChatAPI = () => {
         return (0, instance_1.customInstance)({ url: `/workspaces/${workspaceId}/messagethreads/${id}/messages/stream`, method: 'GET'
         });
     };
-    return { filesUploadFiles, filesGetFileInfo, filesDownloadFile, filesGetUri, flowRunsGetVariables, flowRunsSetVariable, messageThreadsThreadId, messageThreadsGetMessageThreadId, messageThreadsGetComments, messageThreadsPostComment, messageThreadsSetFavoritedChat, messageThreadsThreadMessageCreateByUsersProfileImagesIdMessagecreateduserprofileimages, messageThreadsThreadMessagesIdMessages, messageThreadsStreamThreadMessagesIdMessagesStream, messageThreadsThreadIdName, messageThreadsGetThreadUsers, messageThreadsAddThreadUser, messagesThreadMessages, messagesStartThreadMessage, messagesMessage, messagesGetComments, messagesPostComment, messagesAddValueToMessage, modelsGetModels, modelsGetModel, notificationGet, notificationPutUpdate, notificationPutUpdateall, usersGetUserPhoto, workSpacesGetGet, workSpacesGetId, workSpacesGetAccess, workSpacesThread, workSpacesGetUsers, documentsGetDocumentSas, messageThreadsCreateMessageThread, messageThreadsGetMessageThreadWorkspacesWorkspaceIdMessagethreadsId, messageThreadsThreadMessageCreateByUsersProfileImagesWorkspacesWorkspaceIdMessagethreadsIdMessagecreateduserprofileimages, messageThreadsThreadMessagesWorkspacesWorkspaceIdMessagethreadsIdMessages, messageThreadsStreamThreadMessagesWorkspacesWorkspaceIdMessagethreadsIdMessagesStream };
+    return { filesUploadFiles, filesGetFileInfo, filesDownloadFile, filesGetUri, flowRunsCancelFlowRun, flowRunsGetVariables, flowRunsSetVariable, messageThreadsThreadId, messageThreadsGetMessageThreadId, messageThreadsGetComments, messageThreadsPostComment, messageThreadsSetFavoritedChat, messageThreadsThreadMessageCreateByUsersProfileImagesIdMessagecreateduserprofileimages, messageThreadsThreadMessagesIdMessages, messageThreadsStreamThreadMessagesIdMessagesStream, messageThreadsThreadIdName, messageThreadsGetThreadUsers, messageThreadsAddThreadUser, messagesThreadMessages, messagesStartThreadMessage, messagesMessage, messagesGetComments, messagesPostComment, messagesAddValueToMessage, modelsGetModels, modelsGetModel, notificationGet, notificationPutUpdate, notificationPutUpdateall, usersGetUserPhoto, workSpacesGetGet, workSpacesGetId, workSpacesGetAccess, workSpacesThread, workSpacesGetUsers, documentsGetDocumentSas, messageThreadsCreateMessageThread, messageThreadsGetMessageThreadWorkspacesWorkspaceIdMessagethreadsId, messageThreadsThreadMessageCreateByUsersProfileImagesWorkspacesWorkspaceIdMessagethreadsIdMessagecreateduserprofileimages, messageThreadsThreadMessagesWorkspacesWorkspaceIdMessagethreadsIdMessages, messageThreadsStreamThreadMessagesWorkspacesWorkspaceIdMessagethreadsIdMessagesStream };
 };
 exports.getSmartSpaceChatAPI = getSmartSpaceChatAPI;

package/dist/generated/chat/api.msw.d.ts

@@ -35,6 +35,7 @@ export declare const getFilesUploadFilesMockHandler: (overrideResponse?: void |
 export declare const getFilesGetFileInfoMockHandler: (overrideResponse?: FilesFile | ((info: Parameters<Parameters<typeof http.get>[1]>[0]) => Promise<FilesFile> | FilesFile), options?: RequestHandlerOptions) => import("msw").HttpHandler;
 export declare const getFilesDownloadFileMockHandler: (overrideResponse?: unknown | ((info: Parameters<Parameters<typeof http.get>[1]>[0]) => Promise<unknown> | unknown), options?: RequestHandlerOptions) => import("msw").HttpHandler;
 export declare const getFilesGetUriMockHandler: (overrideResponse?: FilesFileUriResponse | ((info: Parameters<Parameters<typeof http.get>[1]>[0]) => Promise<FilesFileUriResponse> | FilesFileUriResponse), options?: RequestHandlerOptions) => import("msw").HttpHandler;
+export declare const getFlowRunsCancelFlowRunMockHandler: (overrideResponse?: void | ((info: Parameters<Parameters<typeof http.post>[1]>[0]) => Promise<void> | void) | undefined, options?: RequestHandlerOptions) => import("msw").HttpHandler;
 export declare const getFlowRunsGetVariablesMockHandler: (overrideResponse?: FlowRunsGetVariables200One | FlowRunsGetVariables200Two | FlowRunsGetVariables200Three | ((info: Parameters<Parameters<typeof http.get>[1]>[0]) => Promise<FlowRunsGetVariables200One | FlowRunsGetVariables200Two | FlowRunsGetVariables200Three> | FlowRunsGetVariables200One | FlowRunsGetVariables200Two | FlowRunsGetVariables200Three), options?: RequestHandlerOptions) => import("msw").HttpHandler;
 export declare const getFlowRunsSetVariableMockHandler: (overrideResponse?: void | ((info: Parameters<Parameters<typeof http.put>[1]>[0]) => Promise<void> | void) | undefined, options?: RequestHandlerOptions) => import("msw").HttpHandler;
 export declare const getMessageThreadsThreadIdMockHandler: (overrideResponse?: void | ((info: Parameters<Parameters<typeof http.delete>[1]>[0]) => Promise<void> | void) | undefined, options?: RequestHandlerOptions) => import("msw").HttpHandler;

package/dist/generated/chat/api.msw.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getMessagesGetCommentsMockHandler = exports.getMessagesMessageMockHandler = exports.getMessagesStartThreadMessageMockHandler = exports.getMessagesThreadMessagesMockHandler = exports.getMessageThreadsAddThreadUserMockHandler = exports.getMessageThreadsGetThreadUsersMockHandler = exports.getMessageThreadsThreadIdNameMockHandler = exports.getMessageThreadsStreamThreadMessagesIdMessagesStreamMockHandler = exports.getMessageThreadsThreadMessagesIdMessagesMockHandler = exports.getMessageThreadsThreadMessageCreateByUsersProfileImagesIdMessagecreateduserprofileimagesMockHandler = exports.getMessageThreadsSetFavoritedChatMockHandler = exports.getMessageThreadsPostCommentMockHandler = exports.getMessageThreadsGetCommentsMockHandler = exports.getMessageThreadsGetMessageThreadIdMockHandler = exports.getMessageThreadsThreadIdMockHandler = exports.getFlowRunsSetVariableMockHandler = exports.getFlowRunsGetVariablesMockHandler = exports.getFilesGetUriMockHandler = exports.getFilesDownloadFileMockHandler = exports.getFilesGetFileInfoMockHandler = exports.getFilesUploadFilesMockHandler = exports.getMessageThreadsThreadMessagesWorkspacesWorkspaceIdMessagethreadsIdMessagesResponseMock = exports.getMessageThreadsThreadMessageCreateByUsersProfileImagesWorkspacesWorkspaceIdMessagethreadsIdMessagecreateduserprofileimagesResponseMock = exports.getMessageThreadsGetMessageThreadWorkspacesWorkspaceIdMessagethreadsIdResponseMock = exports.getMessageThreadsCreateMessageThreadResponseMock = exports.getDocumentsGetDocumentSasResponseMock = exports.getWorkSpacesGetUsersResponseMock = exports.getWorkSpacesThreadResponseMock = exports.getWorkSpacesGetAccessResponseMock = exports.getWorkSpacesGetIdResponseMock = exports.getWorkSpacesGetGetResponseMock = exports.getUsersGetUserPhotoResponseMock = exports.getNotificationGetResponseMock = exports.getModelsGetModelResponseMock = exports.getModelsGetModelsResponseMock = exports.getMessagesAddValueToMessageResponseMock = exports.getMessagesPostCommentResponseMock = exports.getMessagesGetCommentsResponseMock = exports.getMessagesStartThreadMessageResponseMock = exports.getMessagesThreadMessagesResponseMock = exports.getMessageThreadsGetThreadUsersResponseMock = exports.getMessageThreadsThreadMessagesIdMessagesResponseMock = exports.getMessageThreadsThreadMessageCreateByUsersProfileImagesIdMessagecreateduserprofileimagesResponseMock = exports.getMessageThreadsPostCommentResponseMock = exports.getMessageThreadsGetCommentsResponseMock = exports.getMessageThreadsGetMessageThreadIdResponseMock = exports.getFlowRunsGetVariablesResponseMock = exports.getFilesGetUriResponseMock = exports.getFilesGetFileInfoResponseMock = exports.getFilesUploadFilesResponseMock = void 0;
-exports.getSmartSpaceChatAPIMock = exports.getMessageThreadsStreamThreadMessagesWorkspacesWorkspaceIdMessagethreadsIdMessagesStreamMockHandler = exports.getMessageThreadsThreadMessagesWorkspacesWorkspaceIdMessagethreadsIdMessagesMockHandler = exports.getMessageThreadsThreadMessageCreateByUsersProfileImagesWorkspacesWorkspaceIdMessagethreadsIdMessagecreateduserprofileimagesMockHandler = exports.getMessageThreadsGetMessageThreadWorkspacesWorkspaceIdMessagethreadsIdMockHandler = exports.getMessageThreadsCreateMessageThreadMockHandler = exports.getDocumentsGetDocumentSasMockHandler = exports.getWorkSpacesGetUsersMockHandler = exports.getWorkSpacesThreadMockHandler = exports.getWorkSpacesGetAccessMockHandler = exports.getWorkSpacesGetIdMockHandler = exports.getWorkSpacesGetGetMockHandler = exports.getUsersGetUserPhotoMockHandler = exports.getNotificationPutUpdateallMockHandler = exports.getNotificationPutUpdateMockHandler = exports.getNotificationGetMockHandler = exports.getModelsGetModelMockHandler = exports.getModelsGetModelsMockHandler = exports.getMessagesAddValueToMessageMockHandler = exports.getMessagesPostCommentMockHandler = void 0;
+exports.getMessagesMessageMockHandler = exports.getMessagesStartThreadMessageMockHandler = exports.getMessagesThreadMessagesMockHandler = exports.getMessageThreadsAddThreadUserMockHandler = exports.getMessageThreadsGetThreadUsersMockHandler = exports.getMessageThreadsThreadIdNameMockHandler = exports.getMessageThreadsStreamThreadMessagesIdMessagesStreamMockHandler = exports.getMessageThreadsThreadMessagesIdMessagesMockHandler = exports.getMessageThreadsThreadMessageCreateByUsersProfileImagesIdMessagecreateduserprofileimagesMockHandler = exports.getMessageThreadsSetFavoritedChatMockHandler = exports.getMessageThreadsPostCommentMockHandler = exports.getMessageThreadsGetCommentsMockHandler = exports.getMessageThreadsGetMessageThreadIdMockHandler = exports.getMessageThreadsThreadIdMockHandler = exports.getFlowRunsSetVariableMockHandler = exports.getFlowRunsGetVariablesMockHandler = exports.getFlowRunsCancelFlowRunMockHandler = exports.getFilesGetUriMockHandler = exports.getFilesDownloadFileMockHandler = exports.getFilesGetFileInfoMockHandler = exports.getFilesUploadFilesMockHandler = exports.getMessageThreadsThreadMessagesWorkspacesWorkspaceIdMessagethreadsIdMessagesResponseMock = exports.getMessageThreadsThreadMessageCreateByUsersProfileImagesWorkspacesWorkspaceIdMessagethreadsIdMessagecreateduserprofileimagesResponseMock = exports.getMessageThreadsGetMessageThreadWorkspacesWorkspaceIdMessagethreadsIdResponseMock = exports.getMessageThreadsCreateMessageThreadResponseMock = exports.getDocumentsGetDocumentSasResponseMock = exports.getWorkSpacesGetUsersResponseMock = exports.getWorkSpacesThreadResponseMock = exports.getWorkSpacesGetAccessResponseMock = exports.getWorkSpacesGetIdResponseMock = exports.getWorkSpacesGetGetResponseMock = exports.getUsersGetUserPhotoResponseMock = exports.getNotificationGetResponseMock = exports.getModelsGetModelResponseMock = exports.getModelsGetModelsResponseMock = exports.getMessagesAddValueToMessageResponseMock = exports.getMessagesPostCommentResponseMock = exports.getMessagesGetCommentsResponseMock = exports.getMessagesStartThreadMessageResponseMock = exports.getMessagesThreadMessagesResponseMock = exports.getMessageThreadsGetThreadUsersResponseMock = exports.getMessageThreadsThreadMessagesIdMessagesResponseMock = exports.getMessageThreadsThreadMessageCreateByUsersProfileImagesIdMessagecreateduserprofileimagesResponseMock = exports.getMessageThreadsPostCommentResponseMock = exports.getMessageThreadsGetCommentsResponseMock = exports.getMessageThreadsGetMessageThreadIdResponseMock = exports.getFlowRunsGetVariablesResponseMock = exports.getFilesGetUriResponseMock = exports.getFilesGetFileInfoResponseMock = exports.getFilesUploadFilesResponseMock = void 0;
+exports.getSmartSpaceChatAPIMock = exports.getMessageThreadsStreamThreadMessagesWorkspacesWorkspaceIdMessagethreadsIdMessagesStreamMockHandler = exports.getMessageThreadsThreadMessagesWorkspacesWorkspaceIdMessagethreadsIdMessagesMockHandler = exports.getMessageThreadsThreadMessageCreateByUsersProfileImagesWorkspacesWorkspaceIdMessagethreadsIdMessagecreateduserprofileimagesMockHandler = exports.getMessageThreadsGetMessageThreadWorkspacesWorkspaceIdMessagethreadsIdMockHandler = exports.getMessageThreadsCreateMessageThreadMockHandler = exports.getDocumentsGetDocumentSasMockHandler = exports.getWorkSpacesGetUsersMockHandler = exports.getWorkSpacesThreadMockHandler = exports.getWorkSpacesGetAccessMockHandler = exports.getWorkSpacesGetIdMockHandler = exports.getWorkSpacesGetGetMockHandler = exports.getUsersGetUserPhotoMockHandler = exports.getNotificationPutUpdateallMockHandler = exports.getNotificationPutUpdateMockHandler = exports.getNotificationGetMockHandler = exports.getModelsGetModelMockHandler = exports.getModelsGetModelsMockHandler = exports.getMessagesAddValueToMessageMockHandler = exports.getMessagesPostCommentMockHandler = exports.getMessagesGetCommentsMockHandler = void 0;
 /**
  * Generated by orval v7.13.2 🍺
  * Do not edit manually.
@@ -177,6 +177,17 @@ const getFilesGetUriMockHandler = (overrideResponse, options) => {
     }, options);
 };
 exports.getFilesGetUriMockHandler = getFilesGetUriMockHandler;
+const getFlowRunsCancelFlowRunMockHandler = (overrideResponse, options) => {
+    return msw_1.http.post('*/FlowRuns/:id/cancel', async (info) => {
+        await (0, msw_1.delay)(1000);
+        if (typeof overrideResponse === 'function') {
+            await overrideResponse(info);
+        }
+        return new msw_1.HttpResponse(null, { status: 200,
+        });
+    }, options);
+};
+exports.getFlowRunsCancelFlowRunMockHandler = getFlowRunsCancelFlowRunMockHandler;
 const getFlowRunsGetVariablesMockHandler = (overrideResponse, options) => {
     return msw_1.http.get('*/FlowRuns/:id/variables', async (info) => {
         await (0, msw_1.delay)(1000);
@@ -578,6 +589,7 @@ const getSmartSpaceChatAPIMock = () => [
     (0, exports.getFilesGetFileInfoMockHandler)(),
     (0, exports.getFilesDownloadFileMockHandler)(),
     (0, exports.getFilesGetUriMockHandler)(),
+    (0, exports.getFlowRunsCancelFlowRunMockHandler)(),
     (0, exports.getFlowRunsGetVariablesMockHandler)(),
     (0, exports.getFlowRunsSetVariableMockHandler)(),
     (0, exports.getMessageThreadsThreadIdMockHandler)(),

package/dist/generated/chat/models/accessAccess.d.ts

@@ -6,6 +6,17 @@
  */
 import type { EnumsAccessType } from './enumsAccessType';
 import type { EnumsAppPrincipalType } from './enumsAppPrincipalType';
+/**
+ * Full read shape for an access grant. The model collides on the simple
+name with `SmartSpace.App.Data.Entities.EntityAccess` at the
+namespace alias boundary — but the entity uses a different short name
+(`EntityAccess`), so no alias is required when both are imported.
+            
+Display names (`DisplayName`, `UserEmailAddress`) are not
+columns on the entity — they are resolved at read time from Azure AD via
+`IUserService` / `IAzureADClient` and filled in by the service
+after loading.
+ */
 export interface AccessAccess {
     accessType: EnumsAccessType;
     /** @nullable */

package/dist/generated/chat/models/aiIModelProperty.d.ts

@@ -5,6 +5,12 @@
  * OpenAPI spec version: v1
  */
 import type { EnumsModelPropertyType } from './enumsModelPropertyType';
+/**
+ * Polymorphic AI-model parameter (Number / Boolean / String) — discriminator
+lives on `Type`. The shape is kept because the public JSON contract
+returns the variant-specific fields under one collection; flattening to a
+single record would be a breaking wire-shape change for the admin UI.
+ */
 export interface AiIModelProperty {
     readonly name: string;
     type: EnumsModelPropertyType;

package/dist/generated/chat/models/aiModel.d.ts

@@ -8,6 +8,13 @@ import type { AiModelDeployment } from './aiModelDeployment';
 import type { EnumsModelDeploymentProviderType } from './enumsModelDeploymentProviderType';
 import type { EnumsModelPublisher } from './enumsModelPublisher';
 import type { AiIModelProperty } from './aiIModelProperty';
+/**
+ * Full read model for an AI Model. Collides on the simple name with
+`SmartSpace.App.Data.Entities.Model`; alias
+`DataEntities = SmartSpace.App.Data.Entities` in files that import
+both. The folder is named `AiModels` to avoid the second namespace
+collision with `SmartSpace.App.Business.Models` itself.
+ */
 export interface AiModel {
     /** @nullable */
     createdAt?: string | null;

package/dist/generated/chat/models/aiModelSummary.d.ts

@@ -8,6 +8,11 @@ import type { EnumsModelDeploymentStatus } from './enumsModelDeploymentStatus';
 import type { EnumsModelDeploymentProviderType } from './enumsModelDeploymentProviderType';
 import type { EnumsModelPublisher } from './enumsModelPublisher';
 import type { AiIModelProperty } from './aiIModelProperty';
+/**
+ * Lighter list-endpoint shape — drops the nested `Deployment.Steps`
+collection and keeps a flat `DeploymentStatus` + provider type for
+the AI Models grid.
+ */
 export interface AiModelSummary {
     /** @nullable */
     createdAt?: string | null;

package/dist/generated/chat/models/commentComment.d.ts

@@ -5,6 +5,15 @@
  * OpenAPI spec version: v1
  */
 import type { MentionsMention } from './mentionsMention';
+/**
+ * Model for a Comment. Collides on the simple name with
+`SmartSpace.App.Data.Entities.Comment`; alias
+`DataEntities = SmartSpace.App.Data.Entities` in files that import
+both. `CreatedBy` (display name) sits outside the positional ctor
+because it can't be expression-tree-translated — the service hydrates it
+post-projection via `IUserService`. The nested
+`MentionedUsers[].Name` field follows the same pattern.
+ */
 export interface CommentComment {
     content: string;
     createdAt: string;

package/dist/generated/chat/models/commentCreateComment.d.ts

@@ -4,6 +4,13 @@
  * SmartSpace Chat API
  * OpenAPI spec version: v1
  */
+/**
+ * Request shape for creating a new comment. Posted against either
+`/messages/{id}/comments` or `/messageThreads/{id}/comments` —
+the parent id comes from the route, the body carries content and
+mention list only. Junction-style "no UpdateComment" — edits land as a
+follow-up if/when the feature exists.
+ */
 export interface CommentCreateComment {
     content: string;
     mentionedUsers: string[];

package/dist/generated/chat/models/connectorsConnectorSummary.d.ts

@@ -4,6 +4,12 @@
  * SmartSpace Chat API
  * OpenAPI spec version: v1
  */
+/**
+ * The shape non-admins are allowed to see: enough to pick a connector from a
+dropdown, and nothing more. No URL (that is infrastructure detail) and no
+auth settings. Used by the workspace MCP tab's picker and embedded in the
+workspace detail response so the flow editor can list what is attached.
+ */
 export interface ConnectorsConnectorSummary {
     /** @pattern ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$ */
     id: string;

package/dist/generated/chat/models/filesFile.d.ts

@@ -4,6 +4,18 @@
  * SmartSpace Chat API
  * OpenAPI spec version: v1
  */
+/**
+ * Model for a stored file blob. The simple name collides with
+`System.IO.File` and `SmartSpace.App.Data.Entities.FileEntity`
+(which is itself named to side-step the BCL collision); the
+`SmartSpace.App.Business.Models.Files` namespace disambiguates. When
+importing both this model and the entity, alias the entity side:
+```using DataEntities = SmartSpace.App.Data.Entities;```
+`ThreadId` reflects the entity column `MessageThreadId`
+(renamed at the model boundary because the API contract has always called
+it `threadId`). `WorkspaceId` keeps the lower-s spelling that
+matches the entity column and is already on the wire.
+ */
 export interface FilesFile {
     createdAt: string;
     createdByUserId: string;

package/dist/generated/chat/models/filesFileUriResponse.d.ts

@@ -4,6 +4,13 @@
  * SmartSpace Chat API
  * OpenAPI spec version: v1
  */
+/**
+ * Response shape for `GET /files/{id}/uri` on both the chat-api and
+config-api. Frontends call this with whatever URL the server hands them
+(e.g. as the `sourceUri` on a file MessageValue) and expect a JSON
+object — not a bare string — so the wire format stays extensible (we can
+add e.g. an expiry without breaking clients).
+ */
 export interface FilesFileUriResponse {
     uri: string;
 }

package/dist/generated/chat/models/mentionsMention.d.ts

@@ -4,6 +4,13 @@
  * SmartSpace Chat API
  * OpenAPI spec version: v1
  */
+/**
+ * Model for a single user mention inside a comment. `UserId` matches
+the principal id; `Name` sits outside the positional ctor because
+it can't be expression-tree-translated — the service hydrates it
+post-projection via `IUserService`.
+Comment-level association lives on the parent `Comment` record.
+ */
 export interface MentionsMention {
     /** @nullable */
     name?: string | null;

package/dist/generated/chat/models/notificationsNotification.d.ts

@@ -5,6 +5,15 @@
  * OpenAPI spec version: v1
  */
 import type { EnumsNotificationType } from './enumsNotificationType';
+/**
+ * Model for a Notification. Collides on the simple name with
+`SmartSpace.App.Data.Entities.Notification`; alias
+`DataEntities = SmartSpace.App.Data.Entities` in files that import
+both. `CreatedBy` (display name) sits outside the positional ctor
+because it can't be expression-tree-translated — the service hydrates it
+post-projection via `IUserService.GetPrincipalDisplayNameByIdAsync`
+and emits a `with { CreatedBy = ... }`.
+ */
 export interface NotificationsNotification {
     createdAt: string;
     /** @nullable */

package/dist/generated/chat/models/notificationsPagedNotifications.d.ts

@@ -5,6 +5,10 @@
  * OpenAPI spec version: v1
  */
 import type { NotificationsNotification } from './notificationsNotification';
+/**
+ * Notification list response shape. Two counts so callers can render an
+"X unread of Y total" badge without a second round-trip.
+ */
 export interface NotificationsPagedNotifications {
     data: NotificationsNotification[];
     total: number;

package/dist/generated/chat/models/usersAppUser.d.ts

@@ -4,6 +4,11 @@
  * SmartSpace Chat API
  * OpenAPI spec version: v1
  */
+/**
+ * Azure AD user principal model. Externally-sourced (Microsoft Graph) —
+there is no EF entity for this; the database only persists per-user
+junction state via SmartSpace.App.Business.Models.Users.UserPermission and similar.
+ */
 export interface UsersAppUser {
     displayName: string;
     /** @nullable */

package/dist/generated/chat/models/workSpaceInfo.d.ts

@@ -4,6 +4,12 @@
  * SmartSpace Chat API
  * OpenAPI spec version: v1
  */
+/**
+ * Cross-domain lightweight workspace pointer (id + name) embedded in
+shapes owned by other domains (e.g. SmartSpace.App.Business.Models.DataSpace). Stays
+in the legacy `SmartSpace.App.Business.Models` namespace until
+those domains migrate.
+ */
 export interface WorkSpaceInfo {
     /** @pattern ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$ */
     id: string;

package/dist/generated/chat/models/workSpacesWorkSpace.d.ts

@@ -9,6 +9,15 @@ import type { DataSpace } from './dataSpace';
 import type { WorkSpacesWorkSpaceInputs } from './workSpacesWorkSpaceInputs';
 import type { ModelConfiguration } from './modelConfiguration';
 import type { WorkSpacesWorkSpaceVariables } from './workSpacesWorkSpaceVariables';
+/**
+ * Full read model for a WorkSpace. Collides on the simple name with
+`SmartSpace.App.Data.Entities.WorkSpace`; alias
+`DataEntities = SmartSpace.App.Data.Entities` in files that import
+both. References pre-existing cross-domain models
+(SmartSpace.App.Business.Models.DataSpace, SmartSpace.App.Business.Models.ModelConfiguration,
+SmartSpace.App.Business.Models.Flows.FlowInput, SmartSpace.App.Business.Models.Flows.FlowVariable) — those are not
+re-modelled by this PR.
+ */
 export interface WorkSpacesWorkSpace {
     connectors: ConnectorsConnectorSummary[];
     createdAt: string;

package/dist/generated/chat/zod.d.ts

@@ -101,6 +101,15 @@ export declare const filesGetUriQueryParams: zod.ZodObject<{
 export declare const filesGetUriResponse: zod.ZodObject<{
     uri: zod.ZodString;
 }, zod.core.$strip>;
+/**
+ * @summary Requests cancellation of a queued or running flow run (the chat
+thread id is the flow run id). Cancellation is cooperative: the
+engine stops between block executions, typically within seconds.
+ */
+export declare const flowRunsCancelFlowRunPathIdRegExp: RegExp;
+export declare const flowRunsCancelFlowRunParams: zod.ZodObject<{
+    id: zod.ZodString;
+}, zod.core.$strict>;
 export declare const flowRunsGetVariablesPathIdRegExp: RegExp;
 export declare const flowRunsGetVariablesParams: zod.ZodObject<{
     id: zod.ZodString;