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

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

@@ -6,6 +6,12 @@
  */
 import type { EnumsAccessType } from './enumsAccessType';
 import type { EnumsAppPrincipalType } from './enumsAppPrincipalType';
+/**
+ * Per-workspace access summary surfaced by the "what workspaces does this
+user belong to" lookups. Carries the workspace's name alongside the
+access grant so callers can render the assignment list without an
+additional workspace lookup.
+ */
 export interface AccessAccessWorkSpace {
     accessType: EnumsAccessType;
     /** @nullable */

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

@@ -5,6 +5,10 @@
  * OpenAPI spec version: v1
  */
 import type { EnumsAccessType } from './enumsAccessType';
+/**
+ * Request body for creating an access grant. Access records are junction
+rows — there is no `UpdateAccess`; the convention is delete + create.
+ */
 export interface AccessCreateAccess {
     accessType: EnumsAccessType;
     objectId: string;

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

@@ -6,6 +6,14 @@
  */
 import type { EnumsActivityType } from './enumsActivityType';
 import type { ActivitiesLlmUsageMetrics } from './activitiesLlmUsageMetrics';
+/**
+ * Workspace-scoped activity row returned by the activity log endpoint. The
+`EventDescription`, `Prompt`, `Response`, and
+`QueryNumber` are deserialised from the activity's
+`DisplayName` (a JSON-serialised `WorkSpaceConfiguration`);
+`LlmUsages` and `DurationMs` from `MetricsJson`. Build
+happens in service code — see `ActivityService.GetLogWorkSpaceAsync`.
+ */
 export interface ActivitiesActivityWorkSpace {
     activityType?: EnumsActivityType;
     /** @nullable */

package/dist/generated/config/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/config/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/config/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/config/models/blocksBlockInfo.d.ts

@@ -6,6 +6,12 @@
  */
 import type { BlocksBlockInterface } from './blocksBlockInterface';
 import type { EnumsBlockType } from './enumsBlockType';
+/**
+ * Flattened block descriptor — one `BlockInfo` per (name, version) pair
+across every visible `BlockSet`. This is the shape the
+`BlocksController` returns; the dictionary-of-dictionaries layout is
+reconstructed by the service from the underlying interfaces.
+ */
 export interface BlocksBlockInfo {
     /** @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}$ */
     blockSetId: string;

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

@@ -8,6 +8,15 @@ import type { BlocksBlockInterfaceMetadata } from './blocksBlockInterfaceMetadat
 import type { BlocksBlockInterfacePorts } from './blocksBlockInterfacePorts';
 import type { EnumsBlockScope } from './enumsBlockScope';
 import type { BlocksBlockInterfaceState } from './blocksBlockInterfaceState';
+/**
+ * Model for a block interface — the schema that describes a single
+(name, version) pair of a block (ports, state, scope). Collides on the
+simple name with `SmartSpace.App.Data.Entities.BlockInterface`; alias
+`DataEntities = SmartSpace.App.Data.Entities` in files that import
+both. `Name` and `Version` live on the entity but are surfaced
+here too so the wire shape is self-describing (the same model travels via
+SignalR debug payloads where the keys are stripped).
+ */
 export interface BlocksBlockInterface {
     metadata: BlocksBlockInterfaceMetadata;
     ports: BlocksBlockInterfacePorts;

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

@@ -7,6 +7,13 @@
 import type { BlocksBlockSetBlockInterfaces } from './blocksBlockSetBlockInterfaces';
 import type { EnumsBlockType } from './enumsBlockType';
 import type { BlocksUsedInWorkspaceRef } from './blocksUsedInWorkspaceRef';
+/**
+ * Model for a `BlockSet` — a versioned collection of block interfaces.
+Collides on the simple name with `SmartSpace.App.Data.Entities.BlockSet`;
+alias `DataEntities = SmartSpace.App.Data.Entities` in files that
+import both. `BlockInterfaces` is keyed by block name then version to
+match the API shape consumers expect.
+ */
 export interface BlocksBlockSet {
     blockInterfaces: BlocksBlockSetBlockInterfaces;
     /** @nullable */

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

@@ -9,6 +9,12 @@ import type { BlocksInputPinInterfaceGenerics } from './blocksInputPinInterfaceG
 import type { BlocksInputPinInterfaceMetadata } from './blocksInputPinInterfaceMetadata';
 import type { BlocksInputPinInterfaceSchema } from './blocksInputPinInterfaceSchema';
 import type { EnumsPinType } from './enumsPinType';
+/**
+ * Model for an input pin on a block port. Mirrors the live
+`SmartSpace.App.Data.Entities.InputPinInterface` shape but exposes the
+parsed JSON payloads (`Metadata`, `Schema`, `Generics`,
+`Default`) rather than the raw `*Json` columns.
+ */
 export interface BlocksInputPinInterface {
     channel: boolean;
     /** @nullable */

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

@@ -8,6 +8,12 @@ import type { BlocksOutputPinInterfaceGenerics } from './blocksOutputPinInterfac
 import type { BlocksOutputPinInterfaceMetadata } from './blocksOutputPinInterfaceMetadata';
 import type { BlocksOutputPinInterfaceSchema } from './blocksOutputPinInterfaceSchema';
 import type { EnumsPinType } from './enumsPinType';
+/**
+ * Model for an output pin on a block port. Mirrors the live
+`SmartSpace.App.Data.Entities.OutputPinInterface` shape but exposes the
+parsed JSON payloads (`Metadata`, `Schema`, `Generics`)
+rather than the raw `*Json` columns.
+ */
 export interface BlocksOutputPinInterface {
     channel: boolean;
     /** @nullable */

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

@@ -8,6 +8,11 @@ import type { BlocksPortInterfaceInputs } from './blocksPortInterfaceInputs';
 import type { BlocksPortInterfaceMetadata } from './blocksPortInterfaceMetadata';
 import type { BlocksPortInterfaceOutputs } from './blocksPortInterfaceOutputs';
 import type { EnumsPortType } from './enumsPortType';
+/**
+ * Model for a block `PortInterface`. Inputs and Outputs are keyed by pin
+name (entities store them as `List<...>` with a `Key`
+column; the model exposes them as dictionaries to match the API shape).
+ */
 export interface BlocksPortInterface {
     inputs: BlocksPortInterfaceInputs;
     isFunction: boolean;

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

@@ -7,6 +7,10 @@
 import type { BlocksStateInterfaceDefault } from './blocksStateInterfaceDefault';
 import type { BlocksStateInterfaceMetadata } from './blocksStateInterfaceMetadata';
 import type { FlowsBlockPinRef } from './flowsBlockPinRef';
+/**
+ * Model for a block `StateInterface` — a piece of state declared by a
+block interface, with a JSON default value and an optional pin-ref scope.
+ */
 export interface BlocksStateInterface {
     /** @nullable */
     default?: BlocksStateInterfaceDefault;

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

@@ -4,6 +4,11 @@
  * SmartSpace Admin API
  * OpenAPI spec version: v1
  */
+/**
+ * A workspace that references one of the block set's blocks in its active
+flow definition. Carries the id so the UI can deep-link to the workspace
+designer (e.g. to detach a block before deleting its set).
+ */
 export interface BlocksUsedInWorkspaceRef {
     /** @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/configApiFlowRunIdentityMapRequest.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Generated by orval v7.13.2 🍺
+ * Do not edit manually.
+ * SmartSpace Admin API
+ * OpenAPI spec version: v1
+ */
+export interface ConfigApiFlowRunIdentityMapRequest {
+    ids: string[];
+}

package/dist/generated/config/models/configApiFlowRunIdentityMapRequest.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/connectorsConnector.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Generated by orval v7.13.2 🍺
+ * Do not edit manually.
+ * SmartSpace Admin API
+ * OpenAPI spec version: v1
+ */
+/**
+ * Admin read shape for a connector. Carries the auth SETTINGS (type, header,
+scheme) because an admin editing the connector needs to see them — but
+never the vault reference and never the value. Collides on the simple name
+with `SmartSpace.App.Data.Entities.Connector`; alias
+`DataEntities = SmartSpace.App.Data.Entities` in files importing both.
+ */
+export interface ConnectorsConnector {
+    /** @nullable */
+    authHeaderName?: string | null;
+    /** @nullable */
+    authScheme?: string | null;
+    authType: string;
+    createdAt: string;
+    createdByUserId: string;
+    hasSecret: boolean;
+    /** @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;
+    kind: string;
+    modifiedAt: string;
+    modifiedByUserId: string;
+    name: string;
+    url: string;
+}

package/dist/generated/config/models/connectorsConnector.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/connectorsConnectorSummary.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Generated by orval v7.13.2 🍺
+ * Do not edit manually.
+ * SmartSpace Admin 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;
+    kind: string;
+    name: string;
+}

package/dist/generated/config/models/connectorsConnectorSummary.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/connectorsCreateConnector.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Generated by orval v7.13.2 🍺
+ * Do not edit manually.
+ * SmartSpace Admin API
+ * OpenAPI spec version: v1
+ */
+/**
+ * Create request. One form writes both rows: the connector (identity) and
+its single shared connection (credential). `Secret` is write-only —
+it goes straight to Key Vault and is never returned by any admin endpoint.
+ */
+export interface ConnectorsCreateConnector {
+    /** @nullable */
+    authHeaderName?: string | null;
+    /** @nullable */
+    authScheme?: string | null;
+    authType: string;
+    kind: string;
+    name: string;
+    /** @nullable */
+    secret?: string | null;
+    url: string;
+}

package/dist/generated/config/models/connectorsCreateConnector.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/connectorsGetConnectorSummariesParams.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Generated by orval v7.13.2 🍺
+ * Do not edit manually.
+ * SmartSpace Admin API
+ * OpenAPI spec version: v1
+ */
+export type ConnectorsGetConnectorSummariesParams = {
+    kind?: string;
+};

package/dist/generated/config/models/connectorsGetConnectorSummariesParams.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/connectorsGetConnectorsParams.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Generated by orval v7.13.2 🍺
+ * Do not edit manually.
+ * SmartSpace Admin API
+ * OpenAPI spec version: v1
+ */
+export type ConnectorsGetConnectorsParams = {
+    kind?: string;
+};

package/dist/generated/config/models/connectorsGetConnectorsParams.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/connectorsResolvedConnector.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Generated by orval v7.13.2 🍺
+ * Do not edit manually.
+ * SmartSpace Admin API
+ * OpenAPI spec version: v1
+ */
+import type { ConnectorsResolvedConnectorHeaders } from './connectorsResolvedConnectorHeaders';
+/**
+ * The ONLY shape that carries a usable credential out of the service layer.
+Returned exclusively by `IConnectorService.ResolveAsync`, which backs
+the machine-only resolve endpoint (ssaikey-authenticated AI runtime).
+            
+SmartSpace.App.Business.Models.Connectors.ResolvedConnector.Headers is already composed — the caller attaches them
+verbatim and never sees the raw secret, the header name or the scheme as
+separate facts it has to reassemble.
+ */
+export interface ConnectorsResolvedConnector {
+    headers: ConnectorsResolvedConnectorHeaders;
+    url: string;
+}

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

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

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

@@ -0,0 +1,9 @@
+/**
+ * Generated by orval v7.13.2 🍺
+ * Do not edit manually.
+ * SmartSpace Admin API
+ * OpenAPI spec version: v1
+ */
+export type ConnectorsResolvedConnectorHeaders = {
+    [key: string]: string;
+};

package/dist/generated/config/models/connectorsResolvedConnectorHeaders.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/connectorsUpdateConnector.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Generated by orval v7.13.2 🍺
+ * Do not edit manually.
+ * SmartSpace Admin API
+ * OpenAPI spec version: v1
+ */
+/**
+ * Update request. `Kind` is absent on purpose — changing what a
+connector IS would invalidate every flow referencing it; delete and
+recreate instead.
+            
+`Secret` null means "leave the credential alone". A non-null value
+rotates it: a new version of the SAME vault secret, so the row's reference
+never changes and no orphan is left behind.
+ */
+export interface ConnectorsUpdateConnector {
+    /** @nullable */
+    authHeaderName?: string | null;
+    /** @nullable */
+    authScheme?: string | null;
+    authType: string;
+    name: string;
+    /** @nullable */
+    secret?: string | null;
+    url: string;
+}

package/dist/generated/config/models/connectorsUpdateConnector.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/dataSetsCreateDataSet.d.ts

@@ -5,6 +5,12 @@
  * OpenAPI spec version: v1
  */
 import type { DataSetsCreateDataSetContainer } from './dataSetsCreateDataSetContainer';
+/**
+ * Create-request shape for a DataSet. The DataSpace it belongs to is
+carried on the route (`/DataSpaces/{id}/datasets`) rather than the
+body. Container info is optional — empty list means "file-only" dataset
+with a freshly-created file ingestion flow.
+ */
 export interface DataSetsCreateDataSet {
     /** @nullable */
     containerInfo?: DataSetsCreateDataSetContainer[] | null;

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

@@ -5,6 +5,12 @@
  * OpenAPI spec version: v1
  */
 import type { DataSourcesContainerFilterModel } from './dataSourcesContainerFilterModel';
+/**
+ * Container reference used in create/update requests — pair of
+`DataSourceId` and a `Path` identifying a specific container
+inside that data source. The service hashes the pair to produce the
+container id. Optional Filters restrict which records are synced.
+ */
 export interface DataSetsCreateDataSetContainer {
     /** @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}$ */
     dataSourceId: string;

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

@@ -6,6 +6,20 @@
  */
 import type { DataSetsDataSetProperty } from './dataSetsDataSetProperty';
 import type { EnumsDataSetScopingMode } from './enumsDataSetScopingMode';
+/**
+ * Model for a DataSet. Collides on the simple name with
+`SmartSpace.App.Data.Entities.DataSet`; alias
+`DataEntities = SmartSpace.App.Data.Entities` in files that import
+both.
+            
+The nested Flow shape on the legacy `SmartSpace.App.Business.Models.DataSet`
+is intentionally dropped here — `FlowId` only. The Flow domain
+hasn't migrated yet and projecting its recursive structure (Flow →
+Triggers → DataSourceContainer → DataSource, Flow → ActiveFlowDefinition
+→ Inputs) into the model layer would couple two unmigrated domains and
+bloat every DataSet read with multiple JOIN fan-outs. Callers that need
+Flow detail fetch it via `IFlowService`.
+ */
 export interface DataSetsDataSet {
     createdAt: string;
     createdByUserId: string;

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

@@ -4,6 +4,11 @@
  * SmartSpace Admin API
  * OpenAPI spec version: v1
  */
+/**
+ * Model for a property on a DataSet — a named, optionally-vectorised field
+stored on each ingested item. Read-only at the model boundary; writes go
+through SmartSpace.App.Business.Models.DataSets.UpsertDataSetProperty.
+ */
 export interface DataSetsDataSetProperty {
     /** @nullable */
     description?: string | null;

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

@@ -0,0 +1,15 @@
+/**
+ * Generated by orval v7.13.2 🍺
+ * Do not edit manually.
+ * SmartSpace Admin API
+ * OpenAPI spec version: v1
+ */
+export type DataSetsGetIngestionRunsParams = {
+    skip?: number;
+    take?: number;
+    trigger?: 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}$
+     */
+    itemId?: string;
+};

package/dist/generated/config/models/dataSetsGetIngestionRunsParams.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/dataSetsSetDataSetScoping.d.ts

@@ -5,6 +5,12 @@
  * OpenAPI spec version: v1
  */
 import type { EnumsDataSetScopingMode } from './enumsDataSetScopingMode';
+/**
+ * Sets the per-document scoping config on a dataset (intelligence-layer
+`scoping` block). When `Mode` is `Unrestricted` the
+`SubjectPath` is cleared; when `PerSubject`, `SubjectPath`
+selects the document field to match (null = the built-in owner envelope).
+ */
 export interface DataSetsSetDataSetScoping {
     mode: EnumsDataSetScopingMode;
     /** @nullable */

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

@@ -5,6 +5,12 @@
  * OpenAPI spec version: v1
  */
 import type { DataSetsCreateDataSetContainer } from './dataSetsCreateDataSetContainer';
+/**
+ * Update-request shape for a DataSet — name/description plus optional
+re-binding of containers. Container info null = leave the existing
+flow alone, just update basic fields; empty = disconnect every
+container (soft-deletes all flow triggers).
+ */
 export interface DataSetsUpdateDataSet {
     /** @nullable */
     containerInfo?: DataSetsCreateDataSetContainer[] | null;

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

@@ -4,6 +4,10 @@
  * SmartSpace Admin API
  * OpenAPI spec version: v1
  */
+/**
+ * Lightweight update for just the editable basic-info fields. Used by the
+`PUT /DataSets/{id}/basicInfo` endpoint.
+ */
 export interface DataSetsUpdateDataSetBasicInfo {
     /** @nullable */
     description?: string | null;

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

@@ -4,9 +4,23 @@
  * SmartSpace Admin API
  * OpenAPI spec version: v1
  */
+/**
+ * Upsert payload for a single DataSet property. `Name` is the key —
+existing property with the same name is updated in place, otherwise a
+new one is added.
+ */
 export interface DataSetsUpsertDataSetProperty {
     /** @nullable */
     description?: string | null;
-    isVector: boolean;
+    /**
+     * Unused — the platform no longer reads this field and
+              it has no effect on ingestion or querying. It is retained as an optional
+              property purely for backward compatibility (see the description of
+              `POST /DataSets/{id}/properties`); omit it in new integrations.
+              When omitted, the stored value is preserved on update and defaults to
+              `false` on create.
+     * @nullable
+     */
+    isVector?: boolean | null;
     name: string;
 }

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

@@ -6,6 +6,12 @@
  */
 import type { EnumsDataSourceCredentialType } from './enumsDataSourceCredentialType';
 import type { DataSourcesCreateDataSourceCredentials } from './dataSourcesCreateDataSourceCredentials';
+/**
+ * Create request shape — paired with SmartSpace.App.Business.Models.DataSources.UpdateDataSource even
+though field overlap is partial; the `[Required]` contract differs.
+Accepts inline credentials at creation time (listed under
+`ModelFolderSafetyTests.ExistingDebtToReview`).
+ */
 export interface DataSourcesCreateDataSource {
     credentialType: EnumsDataSourceCredentialType;
     credentials: DataSourcesCreateDataSourceCredentials;

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

@@ -6,6 +6,12 @@
  */
 import type { DataSourceContainer } from './dataSourceContainer';
 import type { EnumsDataSourceCredentialType } from './enumsDataSourceCredentialType';
+/**
+ * Full read shape for a DataSource. Collides on the simple name with
+`SmartSpace.App.Data.Entities.DataSource`; alias
+`DataEntities = SmartSpace.App.Data.Entities` in files that import
+both.
+ */
 export interface DataSourcesDataSource {
     containers: DataSourceContainer[];
     createdAt: string;

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

@@ -4,6 +4,12 @@
  * SmartSpace Admin API
  * OpenAPI spec version: v1
  */
+/**
+ * API response shape for "list admin users on a DataSource" — joins the
+junction SmartSpace.App.Business.Models.DataSources.DataSourceAdmin with the user-service principal
+to surface a display name. Composed in the service; not a Mapperly
+projection target (the join crosses an external service boundary).
+ */
 export interface DataSourcesDataSourceAdminUser {
     id: string;
     name: string;