@smartspace/api-client 0.1.0-dev.67db961 → 0.1.0-dev.691abdb

package/dist/generated/config/models/dataSourcesDataSourceCredentialsDefinition.d.ts

@@ -6,6 +6,11 @@
  */
 import type { DataSourcesCredentialsCredentialsType } from './dataSourcesCredentialsCredentialsType';
 import type { DataSourcesDataSourceProperty } from './dataSourcesDataSourceProperty';
+/**
+ * Schema metadata describing the *shape* of credentials a connector type
+requires — not credential values. Exempted from
+`ModelFolderSafetyTests` via `LegitimateSchemaExceptions`.
+ */
 export interface DataSourcesDataSourceCredentialsDefinition {
     credentialsType: DataSourcesCredentialsCredentialsType;
     properties: DataSourcesDataSourceProperty[];

package/dist/generated/config/models/dataSourcesTestDataSourceConnection.d.ts

@@ -5,6 +5,13 @@
  * OpenAPI spec version: v1
  */
 import type { DataSourcesTestDataSourceConnectionCredentials } from './dataSourcesTestDataSourceConnectionCredentials';
+/**
+ * Request shape for the test-connection endpoint and an internal carrier
+for the data-source-type service when probing credentials. Contains an
+inline credentials dictionary — listed under
+`ModelFolderSafetyTests.ExistingDebtToReview`; redesign to a
+KeyVault-ref-only payload is tracked in TODO.md.
+ */
 export interface DataSourcesTestDataSourceConnection {
     credentials: DataSourcesTestDataSourceConnectionCredentials;
     dataSourceTypeId: string;

package/dist/generated/config/models/dataSourcesUpdateDataSourceCredentials.d.ts

@@ -5,6 +5,12 @@
  * OpenAPI spec version: v1
  */
 import type { DataSourcesUpdateDataSourceCredentialsCredentials } from './dataSourcesUpdateDataSourceCredentialsCredentials';
+/**
+ * Partial-update payload for connector credentials — only non-empty
+values overwrite the existing entries (see
+`DataSourceService.UpdateCredentialsAsync`). Listed under
+`ModelFolderSafetyTests.ExistingDebtToReview`.
+ */
 export interface DataSourcesUpdateDataSourceCredentials {
     credentials: DataSourcesUpdateDataSourceCredentialsCredentials;
 }

package/dist/generated/config/models/dataSpacesCreateDataSpace.d.ts

@@ -4,6 +4,11 @@
  * SmartSpace Admin API
  * OpenAPI spec version: v1
  */
+/**
+ * Create-request shape for a DataSpace. `DataSetIds` is an optional
+pre-attachment of existing datasets to the new dataspace; the creating
+principal is implicitly added as the first admin.
+ */
 export interface DataSpacesCreateDataSpace {
     /** @nullable */
     dataSetIds?: string[] | null;

package/dist/generated/config/models/dataSpacesDataSpace.d.ts

@@ -6,6 +6,15 @@
  */
 import type { DataSetsDataSet } from './dataSetsDataSet';
 import type { DataSpacesDataSpaceWorkSpaceRef } from './dataSpacesDataSpaceWorkSpaceRef';
+/**
+ * Model for a DataSpace. Collides on the simple name with
+`SmartSpace.App.Data.Entities.DataSpace`; alias
+`DataEntities = SmartSpace.App.Data.Entities` in files that import
+both. The fully-qualified `DataSets.DataSet` below also
+disambiguates from the legacy unmigrated `Business.Models.DataSet`
+— implicit name resolution prefers the ancestor namespace and would
+otherwise pick up the legacy record.
+ */
 export interface DataSpacesDataSpace {
     createdAt: string;
     createdByUserId: string;

package/dist/generated/config/models/dataSpacesDataSpaceAdmin.d.ts

@@ -4,9 +4,21 @@
  * SmartSpace Admin API
  * OpenAPI spec version: v1
  */
+/**
+ * Model for a DataSpace admin junction record. The composite key is
+(UserId, DataSpaceId) — no surrogate id. Junction entities follow the
+delete+create convention, so there is no `UpdateDataSpaceAdmin`.
+            
+`DisplayName` is filled by the service via `IUserService`
+post-projection — it isn't on the entity and can't be projected, so it
+hangs off the record as an `init`-only property rather than a
+constructor parameter.
+ */
 export interface DataSpacesDataSpaceAdmin {
     /** @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}$ */
     dataSpaceId: string;
+    /** Display name resolved from `IUserService.GetPrincipalsByIdsAsync`
+  after projection. Empty string when the principal lookup misses. */
     displayName: string;
     userId: string;
 }

package/dist/generated/config/models/dataSpacesDataSpaceWorkSpaceRef.d.ts

@@ -4,6 +4,11 @@
  * SmartSpace Admin API
  * OpenAPI spec version: v1
  */
+/**
+ * Lightweight reference to a WorkSpace that uses this DataSpace. Avoids
+pulling the full WorkSpace shape (admins, flows, configurations) when a
+caller only needs to surface "what workspaces reference this DataSpace".
+ */
 export interface DataSpacesDataSpaceWorkSpaceRef {
     /** @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/config/models/dataSpacesUpdateDataSpace.d.ts

@@ -4,6 +4,12 @@
  * SmartSpace Admin API
  * OpenAPI spec version: v1
  */
+/**
+ * Update-request shape for a DataSpace — rename and re-bind the attached
+datasets. The complete `DataSetIds` list is treated as the desired
+state; datasets present today but missing here are unbound, new ones
+are bound in.
+ */
 export interface DataSpacesUpdateDataSpace {
     dataSetIds: string[];
     /** @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}$ */

package/dist/generated/config/models/draftsDraft.d.ts

@@ -5,6 +5,12 @@
  * OpenAPI spec version: v1
  */
 import type { DraftsDraftBlockInterfaces } from './draftsDraftBlockInterfaces';
+/**
+ * A browser-authored Draft Custom block — a `BlockSet` row with
+`IsDraft = true`, scoped to one user. See `ADR-0002` for the
+resolution rule that decides when the owner's draft wins over a published
+Custom at the same `(name, version)`.
+ */
 export interface DraftsDraft {
     blockInterfaces: DraftsDraftBlockInterfaces;
     isActive: boolean;

package/dist/generated/config/models/draftsPublishDraftRequest.d.ts

@@ -4,6 +4,11 @@
  * SmartSpace Admin API
  * OpenAPI spec version: v1
  */
+/**
+ * `ConfirmOverwrite` must be true to replace an already-published set of
+            the same name — the first attempt 409s with the impact details so the user
+            opts in deliberately (see the custom-block rework design, Phase 3).
+ */
 export interface DraftsPublishDraftRequest {
     confirmOverwrite: boolean;
     /** @nullable */

package/dist/generated/config/models/draftsSaveDraftRequest.d.ts

@@ -4,6 +4,11 @@
  * SmartSpace Admin API
  * OpenAPI spec version: v1
  */
+/**
+ * Save a draft's source. `ExpectedRowVersion` is the value the client last saw;
+the server returns 409 if the DB has moved on (eg. another tab). Null is allowed
+only for first-ever creation.
+ */
 export interface DraftsSaveDraftRequest {
     /** @nullable */
     expectedRowVersion?: string | null;

package/dist/generated/config/models/draftsSaveDraftResponse.d.ts

@@ -5,6 +5,11 @@
  * OpenAPI spec version: v1
  */
 import type { DraftsSaveDraftResponseBlockInterfaces } from './draftsSaveDraftResponseBlockInterfaces';
+/**
+ * Response after saving a draft. `ParseError` is non-null when the source
+failed to parse — the text is still persisted, but `BlockInterfaces` is
+empty until parse succeeds (matches the editor's live-preview semantics).
+ */
 export interface DraftsSaveDraftResponse {
     blockInterfaces: DraftsSaveDraftResponseBlockInterfaces;
     /** @nullable */

package/dist/generated/config/models/enumsNotificationType.d.ts

@@ -9,4 +9,5 @@ export declare const EnumsNotificationType: {
     readonly WorkSpaceUpdated: "WorkSpaceUpdated";
     readonly MessageThreadUpdated: "MessageThreadUpdated";
     readonly CommentUpdated: "CommentUpdated";
+    readonly AddedToThread: "AddedToThread";
 };

package/dist/generated/config/models/enumsNotificationType.js

@@ -12,4 +12,5 @@ exports.EnumsNotificationType = {
     WorkSpaceUpdated: 'WorkSpaceUpdated',
     MessageThreadUpdated: 'MessageThreadUpdated',
     CommentUpdated: 'CommentUpdated',
+    AddedToThread: 'AddedToThread',
 };

package/dist/generated/config/models/filesCreateFileFromBlobUri.d.ts

@@ -4,6 +4,12 @@
  * SmartSpace Admin API
  * OpenAPI spec version: v1
  */
+/**
+ * Request to register an existing blob (already uploaded to storage) as a
+SmartSpace.App.Business.Models.Files.File record bound to an optional flow run. Used by the
+SmartSpace AI ingestion pipeline to call back into the API once it has
+staged a file in blob storage.
+ */
 export interface FilesCreateFileFromBlobUri {
     blobUri: string;
     /**

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

@@ -4,6 +4,18 @@
  * SmartSpace Admin 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/config/models/filesFileUriResponse.d.ts

@@ -4,6 +4,13 @@
  * SmartSpace Admin 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/config/models/filesIngestedBlob.d.ts

@@ -6,6 +6,13 @@
  */
 import type { FilesFile } from './filesFile';
 import type { EnumsIngestionStatus } from './enumsIngestionStatus';
+/**
+ * Model for an ingested blob — pairs a stored SmartSpace.App.Business.Models.Files.IngestedBlob.File with its
+ingestion lifecycle (status, owning dataset, originating flow run).
+`CreatedByUserName` is filled in by the service post-projection
+(display-name lookup via `IUserService`); it is not part of the EF
+projection because it cannot be expression-tree-translated.
+ */
 export interface FilesIngestedBlob {
     /** @nullable */
     createdAt?: string | null;

package/dist/generated/config/models/flowRunsGetWorkspaceRunsParams.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Generated by orval v7.13.2 🍺
+ * Do not edit manually.
+ * SmartSpace Admin API
+ * OpenAPI spec version: v1
+ */
+export type FlowRunsGetWorkspaceRunsParams = {
+    /**
+     * Number of records to skip
+     */
+    skip?: number;
+    /**
+     * Number of records to take
+     */
+    take?: number;
+};

package/dist/generated/config/models/flowRunsGetWorkspaceRunsParams.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Generated by orval v7.13.2 🍺
+ * Do not edit manually.
+ * SmartSpace Admin API
+ * OpenAPI spec version: v1
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/generated/config/models/flowsFlowConstant.d.ts

@@ -6,6 +6,7 @@
  */
 import type { FlowsFlowConstantValue } from './flowsFlowConstantValue';
 export interface FlowsFlowConstant {
+    secret: boolean;
     /** @nullable */
     value?: FlowsFlowConstantValue;
 }

package/dist/generated/config/models/index.d.ts

@@ -62,7 +62,16 @@ export * from './blocksStateInterface';
 export * from './blocksStateInterfaceDefault';
 export * from './blocksStateInterfaceMetadata';
 export * from './blocksUsedInWorkspaceRef';
+export * from './configApiFlowRunIdentityMapRequest';
 export * from './configApiRunFlowRequest';
+export * from './connectorsConnector';
+export * from './connectorsConnectorSummary';
+export * from './connectorsCreateConnector';
+export * from './connectorsGetConnectorSummariesParams';
+export * from './connectorsGetConnectorsParams';
+export * from './connectorsResolvedConnector';
+export * from './connectorsResolvedConnectorHeaders';
+export * from './connectorsUpdateConnector';
 export * from './containerDataSet';
 export * from './containerItem';
 export * from './containersPostParams';
@@ -90,6 +99,7 @@ export * from './dataSetsCreateDataSetContainer';
 export * from './dataSetsDataSet';
 export * from './dataSetsDataSetProperty';
 export * from './dataSetsGetContainerItemsRunHistoryParams';
+export * from './dataSetsGetIngestionRunsParams';
 export * from './dataSetsGetItemsParams';
 export * from './dataSetsGetParams';
 export * from './dataSetsSetDataSetScoping';
@@ -179,6 +189,7 @@ export * from './flowRunsGetStepExecutionsParams';
 export * from './flowRunsGetVariables200One';
 export * from './flowRunsGetVariables200Three';
 export * from './flowRunsGetVariables200Two';
+export * from './flowRunsGetWorkspaceRunsParams';
 export * from './flowRunsSearchFlowRunsParams';
 export * from './flowValueModel';
 export * from './flowValueModelChannels';
@@ -227,7 +238,11 @@ export * from './integrationsSmartSpaceAiFlowPinRef';
 export * from './integrationsSmartSpaceAiFlowValueModel';
 export * from './integrationsSmartSpaceAiFlowValueModelChannels';
 export * from './integrationsSmartSpaceAiFunctionExecutionDebugModel';
+export * from './integrationsSmartSpaceAiIngestionRun';
+export * from './integrationsSmartSpaceAiIngestionRunTrigger';
 export * from './integrationsSmartSpaceAiSdkBlockRef';
+export * from './integrationsSmartSpaceAiSmartSpaceAiPagedDataSystemCollectionsGenericICollectionIntegrationsSmartSpaceAiWorkspaceRun';
+export * from './integrationsSmartSpaceAiWorkspaceRun';
 export * from './managedSecretsCreateManagedSecret';
 export * from './managedSecretsManagedSecret';
 export * from './managedSecretsUpdateManagedSecretValue';
@@ -279,6 +294,7 @@ export * from './pagedDataCollectionWorkSpaceTemplatesTemplate';
 export * from './pagedDataCollectionWorkSpacesWorkSpace';
 export * from './pagedDataSystemCollectionsGenericICollectionDataSetItem';
 export * from './pagedDataSystemCollectionsGenericICollectionIntegrationsSmartSpaceAiContainerItemRunHistory';
+export * from './pagedDataSystemCollectionsGenericICollectionIntegrationsSmartSpaceAiIngestionRun';
 export * from './reportingDuration';
 export * from './reportingGetRequestsParams';
 export * from './reportingGetTokensParams';
@@ -286,8 +302,12 @@ export * from './reportingReportDefinitionSystemDateTime';
 export * from './reportingReportSeries';
 export * from './reportingSplit';
 export * from './sandBoxGetThreadMessagesParams';
+export * from './syncsGetItemsParams';
+export * from './syncsGetParams';
 export * from './syncsSync';
 export * from './syncsSyncDataSourceInfo';
+export * from './syncsSyncQueueState';
+export * from './syncsSyncRunInfo';
 export * from './usersAdminPermissionParams';
 export * from './usersAppAccessUser';
 export * from './usersAppRole';

package/dist/generated/config/models/index.js

@@ -78,7 +78,16 @@ __exportStar(require("./blocksStateInterface"), exports);
 __exportStar(require("./blocksStateInterfaceDefault"), exports);
 __exportStar(require("./blocksStateInterfaceMetadata"), exports);
 __exportStar(require("./blocksUsedInWorkspaceRef"), exports);
+__exportStar(require("./configApiFlowRunIdentityMapRequest"), exports);
 __exportStar(require("./configApiRunFlowRequest"), exports);
+__exportStar(require("./connectorsConnector"), exports);
+__exportStar(require("./connectorsConnectorSummary"), exports);
+__exportStar(require("./connectorsCreateConnector"), exports);
+__exportStar(require("./connectorsGetConnectorSummariesParams"), exports);
+__exportStar(require("./connectorsGetConnectorsParams"), exports);
+__exportStar(require("./connectorsResolvedConnector"), exports);
+__exportStar(require("./connectorsResolvedConnectorHeaders"), exports);
+__exportStar(require("./connectorsUpdateConnector"), exports);
 __exportStar(require("./containerDataSet"), exports);
 __exportStar(require("./containerItem"), exports);
 __exportStar(require("./containersPostParams"), exports);
@@ -106,6 +115,7 @@ __exportStar(require("./dataSetsCreateDataSetContainer"), exports);
 __exportStar(require("./dataSetsDataSet"), exports);
 __exportStar(require("./dataSetsDataSetProperty"), exports);
 __exportStar(require("./dataSetsGetContainerItemsRunHistoryParams"), exports);
+__exportStar(require("./dataSetsGetIngestionRunsParams"), exports);
 __exportStar(require("./dataSetsGetItemsParams"), exports);
 __exportStar(require("./dataSetsGetParams"), exports);
 __exportStar(require("./dataSetsSetDataSetScoping"), exports);
@@ -195,6 +205,7 @@ __exportStar(require("./flowRunsGetStepExecutionsParams"), exports);
 __exportStar(require("./flowRunsGetVariables200One"), exports);
 __exportStar(require("./flowRunsGetVariables200Three"), exports);
 __exportStar(require("./flowRunsGetVariables200Two"), exports);
+__exportStar(require("./flowRunsGetWorkspaceRunsParams"), exports);
 __exportStar(require("./flowRunsSearchFlowRunsParams"), exports);
 __exportStar(require("./flowValueModel"), exports);
 __exportStar(require("./flowValueModelChannels"), exports);
@@ -243,7 +254,11 @@ __exportStar(require("./integrationsSmartSpaceAiFlowPinRef"), exports);
 __exportStar(require("./integrationsSmartSpaceAiFlowValueModel"), exports);
 __exportStar(require("./integrationsSmartSpaceAiFlowValueModelChannels"), exports);
 __exportStar(require("./integrationsSmartSpaceAiFunctionExecutionDebugModel"), exports);
+__exportStar(require("./integrationsSmartSpaceAiIngestionRun"), exports);
+__exportStar(require("./integrationsSmartSpaceAiIngestionRunTrigger"), exports);
 __exportStar(require("./integrationsSmartSpaceAiSdkBlockRef"), exports);
+__exportStar(require("./integrationsSmartSpaceAiSmartSpaceAiPagedDataSystemCollectionsGenericICollectionIntegrationsSmartSpaceAiWorkspaceRun"), exports);
+__exportStar(require("./integrationsSmartSpaceAiWorkspaceRun"), exports);
 __exportStar(require("./managedSecretsCreateManagedSecret"), exports);
 __exportStar(require("./managedSecretsManagedSecret"), exports);
 __exportStar(require("./managedSecretsUpdateManagedSecretValue"), exports);
@@ -295,6 +310,7 @@ __exportStar(require("./pagedDataCollectionWorkSpaceTemplatesTemplate"), exports
 __exportStar(require("./pagedDataCollectionWorkSpacesWorkSpace"), exports);
 __exportStar(require("./pagedDataSystemCollectionsGenericICollectionDataSetItem"), exports);
 __exportStar(require("./pagedDataSystemCollectionsGenericICollectionIntegrationsSmartSpaceAiContainerItemRunHistory"), exports);
+__exportStar(require("./pagedDataSystemCollectionsGenericICollectionIntegrationsSmartSpaceAiIngestionRun"), exports);
 __exportStar(require("./reportingDuration"), exports);
 __exportStar(require("./reportingGetRequestsParams"), exports);
 __exportStar(require("./reportingGetTokensParams"), exports);
@@ -302,8 +318,12 @@ __exportStar(require("./reportingReportDefinitionSystemDateTime"), exports);
 __exportStar(require("./reportingReportSeries"), exports);
 __exportStar(require("./reportingSplit"), exports);
 __exportStar(require("./sandBoxGetThreadMessagesParams"), exports);
+__exportStar(require("./syncsGetItemsParams"), exports);
+__exportStar(require("./syncsGetParams"), exports);
 __exportStar(require("./syncsSync"), exports);
 __exportStar(require("./syncsSyncDataSourceInfo"), exports);
+__exportStar(require("./syncsSyncQueueState"), exports);
+__exportStar(require("./syncsSyncRunInfo"), exports);
 __exportStar(require("./usersAdminPermissionParams"), exports);
 __exportStar(require("./usersAppAccessUser"), exports);
 __exportStar(require("./usersAppRole"), exports);

package/dist/generated/config/models/integrationsSmartSpaceAiContainerItemFlowRun.d.ts

@@ -11,6 +11,7 @@ export interface IntegrationsSmartSpaceAiContainerItemFlowRun {
     finishedAt?: string | null;
     /** @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}$ */
     flowRunId: string;
-    runAt: string;
+    /** @nullable */
+    runAt?: string | null;
     status: string;
 }

package/dist/generated/config/models/integrationsSmartSpaceAiIngestionRun.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Generated by orval v7.13.2 🍺
+ * Do not edit manually.
+ * SmartSpace Admin API
+ * OpenAPI spec version: v1
+ */
+import type { IntegrationsSmartSpaceAiContainerItemFlowRunError } from './integrationsSmartSpaceAiContainerItemFlowRunError';
+import type { IntegrationsSmartSpaceAiIngestionRunTrigger } from './integrationsSmartSpaceAiIngestionRunTrigger';
+export interface IntegrationsSmartSpaceAiIngestionRun {
+    /**
+     * @nullable
+     * @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}$
+     */
+    causedBy?: string | null;
+    /**
+     * @nullable
+     * @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}$
+     */
+    containerId?: string | null;
+    /** @nullable */
+    createdAt?: string | null;
+    /**
+     * @nullable
+     * @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}$
+     */
+    dataSetId?: string | null;
+    /**
+     * @nullable
+     * @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}$
+     */
+    dataSetVersion?: string | null;
+    errors: IntegrationsSmartSpaceAiContainerItemFlowRunError[];
+    /** @nullable */
+    finishedAt?: string | null;
+    /** @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}$ */
+    flowRunId: string;
+    /**
+     * @nullable
+     * @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}$
+     */
+    itemId?: string | null;
+    /** @nullable */
+    itemName?: string | null;
+    /** @nullable */
+    itemPath?: string | null;
+    /** @nullable */
+    itemVersion?: string | null;
+    /**
+     * @nullable
+     * @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}$
+     */
+    retryOf?: string | null;
+    /** @nullable */
+    runAt?: string | null;
+    status: string;
+    trigger: IntegrationsSmartSpaceAiIngestionRunTrigger;
+}

package/dist/generated/config/models/integrationsSmartSpaceAiIngestionRun.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/generated/config/models/integrationsSmartSpaceAiIngestionRunTrigger.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Generated by orval v7.13.2 🍺
+ * Do not edit manually.
+ * SmartSpace Admin API
+ * OpenAPI spec version: v1
+ */
+export interface IntegrationsSmartSpaceAiIngestionRunTrigger {
+    kind: string;
+    /** @nullable */
+    principal?: string | null;
+}

package/dist/generated/config/models/integrationsSmartSpaceAiIngestionRunTrigger.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Generated by orval v7.13.2 🍺
+ * Do not edit manually.
+ * SmartSpace Admin API
+ * OpenAPI spec version: v1
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/generated/config/models/integrationsSmartSpaceAiSmartSpaceAiPagedDataSystemCollectionsGenericICollectionIntegrationsSmartSpaceAiWorkspaceRun.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Generated by orval v7.13.2 🍺
+ * Do not edit manually.
+ * SmartSpace Admin API
+ * OpenAPI spec version: v1
+ */
+import type { IntegrationsSmartSpaceAiWorkspaceRun } from './integrationsSmartSpaceAiWorkspaceRun';
+export interface IntegrationsSmartSpaceAiSmartSpaceAiPagedDataSystemCollectionsGenericICollectionIntegrationsSmartSpaceAiWorkspaceRun {
+    data: IntegrationsSmartSpaceAiWorkspaceRun[];
+    total: number;
+}

package/dist/generated/config/models/integrationsSmartSpaceAiSmartSpaceAiPagedDataSystemCollectionsGenericICollectionIntegrationsSmartSpaceAiWorkspaceRun.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/generated/config/models/integrationsSmartSpaceAiWorkspaceRun.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Generated by orval v7.13.2 🍺
+ * Do not edit manually.
+ * SmartSpace Admin API
+ * OpenAPI spec version: v1
+ */
+export interface IntegrationsSmartSpaceAiWorkspaceRun {
+    /** @nullable */
+    createdAt?: string | null;
+    /** @nullable */
+    finishedAt?: string | null;
+    /**
+     * @nullable
+     * @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}$
+     */
+    flowDefinitionId?: string | null;
+    /**
+     * @nullable
+     * @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}$
+     */
+    flowId?: string | null;
+    /** @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}$ */
+    flowRunId: string;
+    /** @nullable */
+    runAt?: string | null;
+    status: string;
+}

package/dist/generated/config/models/integrationsSmartSpaceAiWorkspaceRun.js

@@ -0,0 +1,8 @@
+"use strict";
+/**
+ * Generated by orval v7.13.2 🍺
+ * Do not edit manually.
+ * SmartSpace Admin API
+ * OpenAPI spec version: v1
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/generated/config/models/managedSecretsCreateManagedSecret.d.ts

@@ -4,6 +4,13 @@
  * SmartSpace Admin API
  * OpenAPI spec version: v1
  */
+/**
+ * Create request shape. `Name` must match the token-safe pattern so it
+embeds cleanly in flow-definition secret tokens; the same rule is enforced
+as a business rule in `ManagedSecretService` (single source:
+`CreateManagedSecret.Pattern`). `Value` is write-only — it goes to
+Key Vault and is never returned by any admin endpoint.
+ */
 export interface ManagedSecretsCreateManagedSecret {
     name: string;
     value: string;

package/dist/generated/config/models/managedSecretsManagedSecret.d.ts

@@ -4,6 +4,14 @@
  * SmartSpace Admin API
  * OpenAPI spec version: v1
  */
+/**
+ * Read/list shape for a managed secret. Deliberately carries NO value property
+and NO vault reference — secret values are write-only through the admin
+surface and only ever leave via the machine-only resolve endpoint
+(SmartSpace.App.Business.Models.ManagedSecrets.ResolvedManagedSecret). Collides on the simple name with
+`SmartSpace.App.Data.Entities.ManagedSecret`; alias
+`DataEntities = SmartSpace.App.Data.Entities` in files that import both.
+ */
 export interface ManagedSecretsManagedSecret {
     createdAt: string;
     createdByUserId: string;

package/dist/generated/config/models/managedSecretsUpdateManagedSecretValue.d.ts

@@ -4,6 +4,10 @@
  * SmartSpace Admin API
  * OpenAPI spec version: v1
  */
+/**
+ * Overwrite-value request shape (rotation). Writes a new version of the same
+Key Vault secret — the row's vault reference is reused, never re-minted.
+ */
 export interface ManagedSecretsUpdateManagedSecretValue {
     value: string;
 }

package/dist/generated/config/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/config/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;