@knowledge-stack/ksapi 1.88.1 → 1.89.0

package/src/models/WorkflowRunResponse.ts

@@ -20,68 +20,116 @@ import {
     WorkflowRunSnapshotToJSON,
     WorkflowRunSnapshotToJSONTyped,
 } from './WorkflowRunSnapshot';
-import type { WorkflowRunStatus } from './WorkflowRunStatus';
+import type { WorkflowExecutionState } from './WorkflowExecutionState';
 import {
-    WorkflowRunStatusFromJSON,
-    WorkflowRunStatusFromJSONTyped,
-    WorkflowRunStatusToJSON,
-    WorkflowRunStatusToJSONTyped,
-} from './WorkflowRunStatus';
-import type { WorkflowRunnerType } from './WorkflowRunnerType';
+    WorkflowExecutionStateFromJSON,
+    WorkflowExecutionStateFromJSONTyped,
+    WorkflowExecutionStateToJSON,
+    WorkflowExecutionStateToJSONTyped,
+} from './WorkflowExecutionState';
+import type { PathPartApprovalState } from './PathPartApprovalState';
 import {
-    WorkflowRunnerTypeFromJSON,
-    WorkflowRunnerTypeFromJSONTyped,
-    WorkflowRunnerTypeToJSON,
-    WorkflowRunnerTypeToJSONTyped,
-} from './WorkflowRunnerType';
+    PathPartApprovalStateFromJSON,
+    PathPartApprovalStateFromJSONTyped,
+    PathPartApprovalStateToJSON,
+    PathPartApprovalStateToJSONTyped,
+} from './PathPartApprovalState';
+import type { UserInfo } from './UserInfo';
+import {
+    UserInfoFromJSON,
+    UserInfoFromJSONTyped,
+    UserInfoToJSON,
+    UserInfoToJSONTyped,
+} from './UserInfo';
 
 /**
  * Workflow run response.
  * 
- * Note: ``run_token_jti`` is intentionally NOT exposed. It's an
- * internal token identifier persisted on the run row for callback
- * auth — clients should treat run dispatch state as observable via
- * ``status`` (RUNNING => dispatched), not via JTI presence.
+ * Doubles as a discriminated-union variant for folder-listing
+ * responses so the FE can mix WD/Run entries with regular folders +
+ * documents and route based on ``part_type``.
+ * 
+ * Two-step flow note: a NOT_STARTED run has ``started_at=None`` and
+ * ``run_snapshot=None``; both are populated when Start dispatches the
+ * run. The flat ``input_path_part_ids`` list carries the
+ * currently-pinned KB references so the FE can render them on a
+ * NOT_STARTED run (the snapshot's typed list is not available yet).
  * @export
  * @interface WorkflowRunResponse
  */
 export interface WorkflowRunResponse {
+    /**
+     * Path part type
+     * @type {WorkflowRunResponsePartTypeEnum}
+     * @memberof WorkflowRunResponse
+     */
+    partType?: WorkflowRunResponsePartTypeEnum;
     /**
      * 
      * @type {string}
      * @memberof WorkflowRunResponse
      */
     id: string;
+    /**
+     * WORKFLOW_RUN path_part of this run
+     * @type {string}
+     * @memberof WorkflowRunResponse
+     */
+    pathPartId: string;
+    /**
+     * FOLDER path_part of the containing folder
+     * @type {string}
+     * @memberof WorkflowRunResponse
+     */
+    parentPathPartId: string | null;
+    /**
+     * Full materialized path from root
+     * @type {string}
+     * @memberof WorkflowRunResponse
+     */
+    materializedPath: string;
     /**
      * 
      * @type {string}
      * @memberof WorkflowRunResponse
      */
-    workflowDefinitionId: string;
+    tenantId: string;
+    /**
+     * Run display name; mirrors ``path_part.name`` (the run's UUID until a slug feature lands).
+     * @type {string}
+     * @memberof WorkflowRunResponse
+     */
+    name: string;
     /**
      * 
      * @type {string}
      * @memberof WorkflowRunResponse
      */
-    userId: string;
+    workflowDefinitionId: string;
     /**
      * 
-     * @type {WorkflowRunnerType}
+     * @type {UserInfo}
      * @memberof WorkflowRunResponse
      */
-    runnerType: WorkflowRunnerType;
+    triggeredBy: UserInfo;
     /**
      * 
-     * @type {WorkflowRunStatus}
+     * @type {WorkflowExecutionState}
      * @memberof WorkflowRunResponse
      */
-    status: WorkflowRunStatus;
+    executionState: WorkflowExecutionState;
     /**
      * 
+     * @type {PathPartApprovalState}
+     * @memberof WorkflowRunResponse
+     */
+    approvalState: PathPartApprovalState;
+    /**
+     * When Start dispatched the run. NULL while the run is NOT_STARTED.
      * @type {Date}
      * @memberof WorkflowRunResponse
      */
-    startedAt: Date;
+    startedAt: Date | null;
     /**
      * 
      * @type {Date}
@@ -89,11 +137,11 @@ export interface WorkflowRunResponse {
      */
     completedAt: Date | null;
     /**
-     * 
+     * Frozen workflow configuration captured at Start time. NULL while the run is NOT_STARTED.
      * @type {WorkflowRunSnapshot}
      * @memberof WorkflowRunResponse
      */
-    runSnapshot: WorkflowRunSnapshot;
+    runSnapshot: WorkflowRunSnapshot | null;
     /**
      * 
      * @type {string}
@@ -101,17 +149,41 @@ export interface WorkflowRunResponse {
      */
     error: string | null;
     /**
-     * 
+     * FOLDER path_part of the run's ``inputs/`` subfolder
+     * @type {string}
+     * @memberof WorkflowRunResponse
+     */
+    inputsPathPartId: string;
+    /**
+     * FOLDER path_part of the run's ``outputs/`` subfolder
+     * @type {string}
+     * @memberof WorkflowRunResponse
+     */
+    outputsPathPartId: string;
+    /**
+     * FOLDER path_part of the run's ``discussions/`` subfolder
+     * @type {string}
+     * @memberof WorkflowRunResponse
+     */
+    discussionsPathPartId: string;
+    /**
+     * Flat list of currently-pinned KB-reference path_part ids (DOCUMENT + FOLDER). On a NOT_STARTED run this is the only surface for KB refs (run_snapshot is NULL).
      * @type {Array<string>}
      * @memberof WorkflowRunResponse
      */
-    inputPathPartIds: Array<string>;
+    inputPathPartIds?: Array<string>;
     /**
      * 
      * @type {Array<string>}
      * @memberof WorkflowRunResponse
      */
-    inputVersionIds: Array<string>;
+    outputsPathPartIds: Array<string>;
+    /**
+     * The run's primary chat thread (1:1). NULL while NOT_STARTED; set by Start. The FE opens the run by opening this thread.
+     * @type {string}
+     * @memberof WorkflowRunResponse
+     */
+    runThreadId?: string | null;
     /**
      * 
      * @type {Date}
@@ -127,6 +199,14 @@ export interface WorkflowRunResponse {
 }
 
 
+/**
+ * @export
+ */
+export const WorkflowRunResponsePartTypeEnum = {
+    WorkflowRun: 'WORKFLOW_RUN'
+} as const;
+export type WorkflowRunResponsePartTypeEnum = typeof WorkflowRunResponsePartTypeEnum[keyof typeof WorkflowRunResponsePartTypeEnum];
+
 export const WorkflowRunResponsePropertyValidationAttributesMap: {
     [property: string]: {
         maxLength?: number,
@@ -150,16 +230,23 @@ export const WorkflowRunResponsePropertyValidationAttributesMap: {
  */
 export function instanceOfWorkflowRunResponse(value: object): value is WorkflowRunResponse {
     if (!('id' in value) || value['id'] === undefined) return false;
+    if (!('pathPartId' in value) || value['pathPartId'] === undefined) return false;
+    if (!('parentPathPartId' in value) || value['parentPathPartId'] === undefined) return false;
+    if (!('materializedPath' in value) || value['materializedPath'] === undefined) return false;
+    if (!('tenantId' in value) || value['tenantId'] === undefined) return false;
+    if (!('name' in value) || value['name'] === undefined) return false;
     if (!('workflowDefinitionId' in value) || value['workflowDefinitionId'] === undefined) return false;
-    if (!('userId' in value) || value['userId'] === undefined) return false;
-    if (!('runnerType' in value) || value['runnerType'] === undefined) return false;
-    if (!('status' in value) || value['status'] === undefined) return false;
+    if (!('triggeredBy' in value) || value['triggeredBy'] === undefined) return false;
+    if (!('executionState' in value) || value['executionState'] === undefined) return false;
+    if (!('approvalState' in value) || value['approvalState'] === undefined) return false;
     if (!('startedAt' in value) || value['startedAt'] === undefined) return false;
     if (!('completedAt' in value) || value['completedAt'] === undefined) return false;
     if (!('runSnapshot' in value) || value['runSnapshot'] === undefined) return false;
     if (!('error' in value) || value['error'] === undefined) return false;
-    if (!('inputPathPartIds' in value) || value['inputPathPartIds'] === undefined) return false;
-    if (!('inputVersionIds' in value) || value['inputVersionIds'] === undefined) return false;
+    if (!('inputsPathPartId' in value) || value['inputsPathPartId'] === undefined) return false;
+    if (!('outputsPathPartId' in value) || value['outputsPathPartId'] === undefined) return false;
+    if (!('discussionsPathPartId' in value) || value['discussionsPathPartId'] === undefined) return false;
+    if (!('outputsPathPartIds' in value) || value['outputsPathPartIds'] === undefined) return false;
     if (!('createdAt' in value) || value['createdAt'] === undefined) return false;
     if (!('updatedAt' in value) || value['updatedAt'] === undefined) return false;
     return true;
@@ -175,17 +262,27 @@ export function WorkflowRunResponseFromJSONTyped(json: any, ignoreDiscriminator:
     }
     return {
         
+        'partType': json['part_type'] == null ? undefined : json['part_type'],
         'id': json['id'],
+        'pathPartId': json['path_part_id'],
+        'parentPathPartId': json['parent_path_part_id'],
+        'materializedPath': json['materialized_path'],
+        'tenantId': json['tenant_id'],
+        'name': json['name'],
         'workflowDefinitionId': json['workflow_definition_id'],
-        'userId': json['user_id'],
-        'runnerType': WorkflowRunnerTypeFromJSON(json['runner_type']),
-        'status': WorkflowRunStatusFromJSON(json['status']),
-        'startedAt': (new Date(json['started_at'])),
+        'triggeredBy': UserInfoFromJSON(json['triggered_by']),
+        'executionState': WorkflowExecutionStateFromJSON(json['execution_state']),
+        'approvalState': PathPartApprovalStateFromJSON(json['approval_state']),
+        'startedAt': (json['started_at'] == null ? null : new Date(json['started_at'])),
         'completedAt': (json['completed_at'] == null ? null : new Date(json['completed_at'])),
         'runSnapshot': WorkflowRunSnapshotFromJSON(json['run_snapshot']),
         'error': json['error'],
-        'inputPathPartIds': json['input_path_part_ids'],
-        'inputVersionIds': json['input_version_ids'],
+        'inputsPathPartId': json['inputs_path_part_id'],
+        'outputsPathPartId': json['outputs_path_part_id'],
+        'discussionsPathPartId': json['discussions_path_part_id'],
+        'inputPathPartIds': json['input_path_part_ids'] == null ? undefined : json['input_path_part_ids'],
+        'outputsPathPartIds': json['outputs_path_part_ids'],
+        'runThreadId': json['run_thread_id'] == null ? undefined : json['run_thread_id'],
         'createdAt': (new Date(json['created_at'])),
         'updatedAt': (new Date(json['updated_at'])),
     };
@@ -202,17 +299,27 @@ export function WorkflowRunResponseToJSONTyped(value?: WorkflowRunResponse | nul
 
     return {
         
+        'part_type': value['partType'],
         'id': value['id'],
+        'path_part_id': value['pathPartId'],
+        'parent_path_part_id': value['parentPathPartId'],
+        'materialized_path': value['materializedPath'],
+        'tenant_id': value['tenantId'],
+        'name': value['name'],
         'workflow_definition_id': value['workflowDefinitionId'],
-        'user_id': value['userId'],
-        'runner_type': WorkflowRunnerTypeToJSON(value['runnerType']),
-        'status': WorkflowRunStatusToJSON(value['status']),
-        'started_at': value['startedAt'].toISOString(),
+        'triggered_by': UserInfoToJSON(value['triggeredBy']),
+        'execution_state': WorkflowExecutionStateToJSON(value['executionState']),
+        'approval_state': PathPartApprovalStateToJSON(value['approvalState']),
+        'started_at': value['startedAt'] == null ? value['startedAt'] : value['startedAt'].toISOString(),
         'completed_at': value['completedAt'] == null ? value['completedAt'] : value['completedAt'].toISOString(),
         'run_snapshot': WorkflowRunSnapshotToJSON(value['runSnapshot']),
         'error': value['error'],
+        'inputs_path_part_id': value['inputsPathPartId'],
+        'outputs_path_part_id': value['outputsPathPartId'],
+        'discussions_path_part_id': value['discussionsPathPartId'],
         'input_path_part_ids': value['inputPathPartIds'],
-        'input_version_ids': value['inputVersionIds'],
+        'outputs_path_part_ids': value['outputsPathPartIds'],
+        'run_thread_id': value['runThreadId'],
         'created_at': value['createdAt'].toISOString(),
         'updated_at': value['updatedAt'].toISOString(),
     };

package/src/models/WorkflowRunSnapshot.ts

@@ -13,13 +13,13 @@
  */
 
 import { mapValues } from '../runtime';
-import type { ABCDPathSnapshot } from './ABCDPathSnapshot';
+import type { InputSnapshot } from './InputSnapshot';
 import {
-    ABCDPathSnapshotFromJSON,
-    ABCDPathSnapshotFromJSONTyped,
-    ABCDPathSnapshotToJSON,
-    ABCDPathSnapshotToJSONTyped,
-} from './ABCDPathSnapshot';
+    InputSnapshotFromJSON,
+    InputSnapshotFromJSONTyped,
+    InputSnapshotToJSON,
+    InputSnapshotToJSONTyped,
+} from './InputSnapshot';
 import type { InstructionSnapshot } from './InstructionSnapshot';
 import {
     InstructionSnapshotFromJSON,
@@ -27,44 +27,27 @@ import {
     InstructionSnapshotToJSON,
     InstructionSnapshotToJSONTyped,
 } from './InstructionSnapshot';
-import type { WorkflowRunnerType } from './WorkflowRunnerType';
-import {
-    WorkflowRunnerTypeFromJSON,
-    WorkflowRunnerTypeFromJSONTyped,
-    WorkflowRunnerTypeToJSON,
-    WorkflowRunnerTypeToJSONTyped,
-} from './WorkflowRunnerType';
 
 /**
- * Frozen ABCD configuration captured at workflow trigger time.
+ * Frozen workflow configuration captured at trigger time.
+ * 
+ * ``workflow_definition_id`` and ``user_id`` are NOT stored here — they
+ * live directly on the ``WorkflowRun`` row and are surfaced via
+ * ``WorkflowRunResponse`` top-level fields.
+ * 
+ * Inputs are per-run; outputs land in the run's ``outputs/`` folder. The
+ * agent resolves the run's inputs/outputs/discussions folders by listing
+ * the run-folder children at activity startup.
  * @export
  * @interface WorkflowRunSnapshot
  */
 export interface WorkflowRunSnapshot {
-    /**
-     * 
-     * @type {string}
-     * @memberof WorkflowRunSnapshot
-     */
-    workflowDefinitionId: string;
     /**
      * 
      * @type {string}
      * @memberof WorkflowRunSnapshot
      */
     workflowName: string;
-    /**
-     * 
-     * @type {WorkflowRunnerType}
-     * @memberof WorkflowRunSnapshot
-     */
-    runnerType: WorkflowRunnerType;
-    /**
-     * 
-     * @type {string}
-     * @memberof WorkflowRunSnapshot
-     */
-    userId: string;
     /**
      * 
      * @type {number}
@@ -73,31 +56,17 @@ export interface WorkflowRunSnapshot {
     maxRunDurationSeconds: number;
     /**
      * 
-     * @type {Array<ABCDPathSnapshot>}
-     * @memberof WorkflowRunSnapshot
-     */
-    sources: Array<ABCDPathSnapshot>;
-    /**
-     * 
-     * @type {Array<InstructionSnapshot>}
+     * @type {InstructionSnapshot}
      * @memberof WorkflowRunSnapshot
      */
-    instructions: Array<InstructionSnapshot>;
+    instruction: InstructionSnapshot;
     /**
      * 
-     * @type {Array<ABCDPathSnapshot>}
+     * @type {Array<InputSnapshot>}
      * @memberof WorkflowRunSnapshot
      */
-    outputs: Array<ABCDPathSnapshot>;
-    /**
-     * 
-     * @type {ABCDPathSnapshot}
-     * @memberof WorkflowRunSnapshot
-     */
-    template: ABCDPathSnapshot | null;
+    inputs: Array<InputSnapshot>;
 }
-
-
 export const WorkflowRunSnapshotPropertyValidationAttributesMap: {
     [property: string]: {
         maxLength?: number,
@@ -120,15 +89,10 @@ export const WorkflowRunSnapshotPropertyValidationAttributesMap: {
  * Check if a given object implements the WorkflowRunSnapshot interface.
  */
 export function instanceOfWorkflowRunSnapshot(value: object): value is WorkflowRunSnapshot {
-    if (!('workflowDefinitionId' in value) || value['workflowDefinitionId'] === undefined) return false;
     if (!('workflowName' in value) || value['workflowName'] === undefined) return false;
-    if (!('runnerType' in value) || value['runnerType'] === undefined) return false;
-    if (!('userId' in value) || value['userId'] === undefined) return false;
     if (!('maxRunDurationSeconds' in value) || value['maxRunDurationSeconds'] === undefined) return false;
-    if (!('sources' in value) || value['sources'] === undefined) return false;
-    if (!('instructions' in value) || value['instructions'] === undefined) return false;
-    if (!('outputs' in value) || value['outputs'] === undefined) return false;
-    if (!('template' in value) || value['template'] === undefined) return false;
+    if (!('instruction' in value) || value['instruction'] === undefined) return false;
+    if (!('inputs' in value) || value['inputs'] === undefined) return false;
     return true;
 }
 
@@ -142,15 +106,10 @@ export function WorkflowRunSnapshotFromJSONTyped(json: any, ignoreDiscriminator:
     }
     return {
         
-        'workflowDefinitionId': json['workflow_definition_id'],
         'workflowName': json['workflow_name'],
-        'runnerType': WorkflowRunnerTypeFromJSON(json['runner_type']),
-        'userId': json['user_id'],
         'maxRunDurationSeconds': json['max_run_duration_seconds'],
-        'sources': ((json['sources'] as Array<any>).map(ABCDPathSnapshotFromJSON)),
-        'instructions': ((json['instructions'] as Array<any>).map(InstructionSnapshotFromJSON)),
-        'outputs': ((json['outputs'] as Array<any>).map(ABCDPathSnapshotFromJSON)),
-        'template': ABCDPathSnapshotFromJSON(json['template']),
+        'instruction': InstructionSnapshotFromJSON(json['instruction']),
+        'inputs': ((json['inputs'] as Array<any>).map(InputSnapshotFromJSON)),
     };
 }
 
@@ -165,15 +124,10 @@ export function WorkflowRunSnapshotToJSONTyped(value?: WorkflowRunSnapshot | nul
 
     return {
         
-        'workflow_definition_id': value['workflowDefinitionId'],
         'workflow_name': value['workflowName'],
-        'runner_type': WorkflowRunnerTypeToJSON(value['runnerType']),
-        'user_id': value['userId'],
         'max_run_duration_seconds': value['maxRunDurationSeconds'],
-        'sources': ((value['sources'] as Array<any>).map(ABCDPathSnapshotToJSON)),
-        'instructions': ((value['instructions'] as Array<any>).map(InstructionSnapshotToJSON)),
-        'outputs': ((value['outputs'] as Array<any>).map(ABCDPathSnapshotToJSON)),
-        'template': ABCDPathSnapshotToJSON(value['template']),
+        'instruction': InstructionSnapshotToJSON(value['instruction']),
+        'inputs': ((value['inputs'] as Array<any>).map(InputSnapshotToJSON)),
     };
 }
 

package/src/models/XlsxCellAnchorInput.ts

@@ -0,0 +1,138 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management
+ *
+ * The version of the OpenAPI document: 0.1.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+import { mapValues } from '../runtime';
+import type { CitedChunk } from './CitedChunk';
+import {
+    CitedChunkFromJSON,
+    CitedChunkFromJSONTyped,
+    CitedChunkToJSON,
+    CitedChunkToJSONTyped,
+} from './CitedChunk';
+
+/**
+ * One citation anchored to a cell in an .xlsx deliverable.
+ * @export
+ * @interface XlsxCellAnchorInput
+ */
+export interface XlsxCellAnchorInput {
+    /**
+     * 
+     * @type {XlsxCellAnchorInputTypeEnum}
+     * @memberof XlsxCellAnchorInput
+     */
+    type?: XlsxCellAnchorInputTypeEnum;
+    /**
+     * 
+     * @type {string}
+     * @memberof XlsxCellAnchorInput
+     */
+    sheetName: string;
+    /**
+     * Coordinate like 'B23'.
+     * @type {string}
+     * @memberof XlsxCellAnchorInput
+     */
+    cellAddress: string;
+    /**
+     * Cited chunks in the order they appeared in the comment body, each with the source-document snapshot resolved at save time.
+     * @type {Array<CitedChunk>}
+     * @memberof XlsxCellAnchorInput
+     */
+    citations: Array<CitedChunk>;
+    /**
+     * Cached cell value at this anchor, for FE display. NOT the cited quote. Empty when the cell holds a formula whose cache has not been refreshed.
+     * @type {string}
+     * @memberof XlsxCellAnchorInput
+     */
+    anchorText?: string;
+}
+
+
+/**
+ * @export
+ */
+export const XlsxCellAnchorInputTypeEnum = {
+    XlsxCell: 'xlsx_cell'
+} as const;
+export type XlsxCellAnchorInputTypeEnum = typeof XlsxCellAnchorInputTypeEnum[keyof typeof XlsxCellAnchorInputTypeEnum];
+
+export const XlsxCellAnchorInputPropertyValidationAttributesMap: {
+    [property: string]: {
+        maxLength?: number,
+        minLength?: number,
+        pattern?: string,
+        maximum?: number,
+        exclusiveMaximum?: boolean,
+        minimum?: number,
+        exclusiveMinimum?: boolean,
+        multipleOf?: number,
+        maxItems?: number,
+        minItems?: number,
+        uniqueItems?: boolean
+    }
+} = {
+    anchorText: {
+        maxLength: 160,
+    },
+}
+
+
+/**
+ * Check if a given object implements the XlsxCellAnchorInput interface.
+ */
+export function instanceOfXlsxCellAnchorInput(value: object): value is XlsxCellAnchorInput {
+    if (!('sheetName' in value) || value['sheetName'] === undefined) return false;
+    if (!('cellAddress' in value) || value['cellAddress'] === undefined) return false;
+    if (!('citations' in value) || value['citations'] === undefined) return false;
+    return true;
+}
+
+export function XlsxCellAnchorInputFromJSON(json: any): XlsxCellAnchorInput {
+    return XlsxCellAnchorInputFromJSONTyped(json, false);
+}
+
+export function XlsxCellAnchorInputFromJSONTyped(json: any, ignoreDiscriminator: boolean): XlsxCellAnchorInput {
+    if (json == null) {
+        return json;
+    }
+    return {
+        
+        'type': json['type'] == null ? undefined : json['type'],
+        'sheetName': json['sheet_name'],
+        'cellAddress': json['cell_address'],
+        'citations': ((json['citations'] as Array<any>).map(CitedChunkFromJSON)),
+        'anchorText': json['anchor_text'] == null ? undefined : json['anchor_text'],
+    };
+}
+
+export function XlsxCellAnchorInputToJSON(json: any): XlsxCellAnchorInput {
+    return XlsxCellAnchorInputToJSONTyped(json, false);
+}
+
+export function XlsxCellAnchorInputToJSONTyped(value?: XlsxCellAnchorInput | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+
+    return {
+        
+        'type': value['type'],
+        'sheet_name': value['sheetName'],
+        'cell_address': value['cellAddress'],
+        'citations': ((value['citations'] as Array<any>).map(CitedChunkToJSON)),
+        'anchor_text': value['anchorText'],
+    };
+}
+

package/src/models/XlsxCellAnchorInputOrDocxParagraphAnchorInput.ts

@@ -0,0 +1,72 @@
+/* tslint:disable */
+/* eslint-disable */
+/**
+ * Knowledge Stack API
+ * Knowledge Stack backend API for authentication and knowledge management
+ *
+ * The version of the OpenAPI document: 0.1.0
+ * 
+ *
+ * NOTE: This class is auto generated by OpenAPI Generator (https://openapi-generator.tech).
+ * https://openapi-generator.tech
+ * Do not edit the class manually.
+ */
+
+import type { DocxParagraphAnchorInput } from './DocxParagraphAnchorInput';
+import {
+    instanceOfDocxParagraphAnchorInput,
+    DocxParagraphAnchorInputFromJSON,
+    DocxParagraphAnchorInputFromJSONTyped,
+    DocxParagraphAnchorInputToJSON,
+} from './DocxParagraphAnchorInput';
+import type { XlsxCellAnchorInput } from './XlsxCellAnchorInput';
+import {
+    instanceOfXlsxCellAnchorInput,
+    XlsxCellAnchorInputFromJSON,
+    XlsxCellAnchorInputFromJSONTyped,
+    XlsxCellAnchorInputToJSON,
+} from './XlsxCellAnchorInput';
+
+/**
+ * @type XlsxCellAnchorInputOrDocxParagraphAnchorInput
+ * 
+ * @export
+ */
+export type XlsxCellAnchorInputOrDocxParagraphAnchorInput = { type: 'docx_paragraph' } & DocxParagraphAnchorInput | { type: 'xlsx_cell' } & XlsxCellAnchorInput;
+
+export function XlsxCellAnchorInputOrDocxParagraphAnchorInputFromJSON(json: any): XlsxCellAnchorInputOrDocxParagraphAnchorInput {
+    return XlsxCellAnchorInputOrDocxParagraphAnchorInputFromJSONTyped(json, false);
+}
+
+export function XlsxCellAnchorInputOrDocxParagraphAnchorInputFromJSONTyped(json: any, ignoreDiscriminator: boolean): XlsxCellAnchorInputOrDocxParagraphAnchorInput {
+    if (json == null) {
+        return json;
+    }
+    switch (json['type']) {
+        case 'docx_paragraph':
+            return Object.assign({}, DocxParagraphAnchorInputFromJSONTyped(json, true), { type: 'docx_paragraph' } as const);
+        case 'xlsx_cell':
+            return Object.assign({}, XlsxCellAnchorInputFromJSONTyped(json, true), { type: 'xlsx_cell' } as const);
+        default:
+            return json;
+    }
+}
+
+export function XlsxCellAnchorInputOrDocxParagraphAnchorInputToJSON(json: any): any {
+    return XlsxCellAnchorInputOrDocxParagraphAnchorInputToJSONTyped(json, false);
+}
+
+export function XlsxCellAnchorInputOrDocxParagraphAnchorInputToJSONTyped(value?: XlsxCellAnchorInputOrDocxParagraphAnchorInput | null, ignoreDiscriminator: boolean = false): any {
+    if (value == null) {
+        return value;
+    }
+    switch (value['type']) {
+        case 'docx_paragraph':
+            return Object.assign({}, DocxParagraphAnchorInputToJSON(value), { type: 'docx_paragraph' } as const);
+        case 'xlsx_cell':
+            return Object.assign({}, XlsxCellAnchorInputToJSON(value), { type: 'xlsx_cell' } as const);
+        default:
+            return value;
+    }
+}
+