@knowledge-stack/ksapi 1.88.1 → 1.89.0

package/dist/models/WorkflowRunResponse.js

@@ -13,15 +13,22 @@
  * Do not edit the class manually.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.WorkflowRunResponsePropertyValidationAttributesMap = void 0;
+exports.WorkflowRunResponsePropertyValidationAttributesMap = exports.WorkflowRunResponsePartTypeEnum = void 0;
 exports.instanceOfWorkflowRunResponse = instanceOfWorkflowRunResponse;
 exports.WorkflowRunResponseFromJSON = WorkflowRunResponseFromJSON;
 exports.WorkflowRunResponseFromJSONTyped = WorkflowRunResponseFromJSONTyped;
 exports.WorkflowRunResponseToJSON = WorkflowRunResponseToJSON;
 exports.WorkflowRunResponseToJSONTyped = WorkflowRunResponseToJSONTyped;
 const WorkflowRunSnapshot_1 = require("./WorkflowRunSnapshot");
-const WorkflowRunStatus_1 = require("./WorkflowRunStatus");
-const WorkflowRunnerType_1 = require("./WorkflowRunnerType");
+const WorkflowExecutionState_1 = require("./WorkflowExecutionState");
+const PathPartApprovalState_1 = require("./PathPartApprovalState");
+const UserInfo_1 = require("./UserInfo");
+/**
+ * @export
+ */
+exports.WorkflowRunResponsePartTypeEnum = {
+    WorkflowRun: 'WORKFLOW_RUN'
+};
 exports.WorkflowRunResponsePropertyValidationAttributesMap = {};
 /**
  * Check if a given object implements the WorkflowRunResponse interface.
@@ -29,13 +36,23 @@ exports.WorkflowRunResponsePropertyValidationAttributesMap = {};
 function instanceOfWorkflowRunResponse(value) {
     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)
+    if (!('triggeredBy' in value) || value['triggeredBy'] === undefined)
         return false;
-    if (!('runnerType' in value) || value['runnerType'] === undefined)
+    if (!('executionState' in value) || value['executionState'] === undefined)
         return false;
-    if (!('status' in value) || value['status'] === undefined)
+    if (!('approvalState' in value) || value['approvalState'] === undefined)
         return false;
     if (!('startedAt' in value) || value['startedAt'] === undefined)
         return false;
@@ -45,9 +62,13 @@ function instanceOfWorkflowRunResponse(value) {
         return false;
     if (!('error' in value) || value['error'] === undefined)
         return false;
-    if (!('inputPathPartIds' in value) || value['inputPathPartIds'] === undefined)
+    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 (!('inputVersionIds' in value) || value['inputVersionIds'] === undefined)
+    if (!('outputsPathPartIds' in value) || value['outputsPathPartIds'] === undefined)
         return false;
     if (!('createdAt' in value) || value['createdAt'] === undefined)
         return false;
@@ -63,17 +84,27 @@ function WorkflowRunResponseFromJSONTyped(json, ignoreDiscriminator) {
         return json;
     }
     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': (0, WorkflowRunnerType_1.WorkflowRunnerTypeFromJSON)(json['runner_type']),
-        'status': (0, WorkflowRunStatus_1.WorkflowRunStatusFromJSON)(json['status']),
-        'startedAt': (new Date(json['started_at'])),
+        'triggeredBy': (0, UserInfo_1.UserInfoFromJSON)(json['triggered_by']),
+        'executionState': (0, WorkflowExecutionState_1.WorkflowExecutionStateFromJSON)(json['execution_state']),
+        'approvalState': (0, PathPartApprovalState_1.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': (0, WorkflowRunSnapshot_1.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'])),
     };
@@ -86,17 +117,27 @@ function WorkflowRunResponseToJSONTyped(value, ignoreDiscriminator = false) {
         return value;
     }
     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': (0, WorkflowRunnerType_1.WorkflowRunnerTypeToJSON)(value['runnerType']),
-        'status': (0, WorkflowRunStatus_1.WorkflowRunStatusToJSON)(value['status']),
-        'started_at': value['startedAt'].toISOString(),
+        'triggered_by': (0, UserInfo_1.UserInfoToJSON)(value['triggeredBy']),
+        'execution_state': (0, WorkflowExecutionState_1.WorkflowExecutionStateToJSON)(value['executionState']),
+        'approval_state': (0, PathPartApprovalState_1.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': (0, WorkflowRunSnapshot_1.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/dist/models/WorkflowRunSnapshot.d.ts

@@ -9,39 +9,28 @@
  * https://openapi-generator.tech
  * Do not edit the class manually.
  */
-import type { ABCDPathSnapshot } from './ABCDPathSnapshot';
+import type { InputSnapshot } from './InputSnapshot';
 import type { InstructionSnapshot } from './InstructionSnapshot';
-import type { WorkflowRunnerType } 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}
@@ -50,28 +39,16 @@ export interface WorkflowRunSnapshot {
     maxRunDurationSeconds: number;
     /**
      *
-     * @type {Array<ABCDPathSnapshot>}
-     * @memberof WorkflowRunSnapshot
-     */
-    sources: Array<ABCDPathSnapshot>;
-    /**
-     *
-     * @type {Array<InstructionSnapshot>}
-     * @memberof WorkflowRunSnapshot
-     */
-    instructions: Array<InstructionSnapshot>;
-    /**
-     *
-     * @type {Array<ABCDPathSnapshot>}
+     * @type {InstructionSnapshot}
      * @memberof WorkflowRunSnapshot
      */
-    outputs: Array<ABCDPathSnapshot>;
+    instruction: InstructionSnapshot;
     /**
      *
-     * @type {ABCDPathSnapshot}
+     * @type {Array<InputSnapshot>}
      * @memberof WorkflowRunSnapshot
      */
-    template: ABCDPathSnapshot | null;
+    inputs: Array<InputSnapshot>;
 }
 export declare const WorkflowRunSnapshotPropertyValidationAttributesMap: {
     [property: string]: {

package/dist/models/WorkflowRunSnapshot.js

@@ -19,31 +19,20 @@ exports.WorkflowRunSnapshotFromJSON = WorkflowRunSnapshotFromJSON;
 exports.WorkflowRunSnapshotFromJSONTyped = WorkflowRunSnapshotFromJSONTyped;
 exports.WorkflowRunSnapshotToJSON = WorkflowRunSnapshotToJSON;
 exports.WorkflowRunSnapshotToJSONTyped = WorkflowRunSnapshotToJSONTyped;
-const ABCDPathSnapshot_1 = require("./ABCDPathSnapshot");
+const InputSnapshot_1 = require("./InputSnapshot");
 const InstructionSnapshot_1 = require("./InstructionSnapshot");
-const WorkflowRunnerType_1 = require("./WorkflowRunnerType");
 exports.WorkflowRunSnapshotPropertyValidationAttributesMap = {};
 /**
  * Check if a given object implements the WorkflowRunSnapshot interface.
  */
 function instanceOfWorkflowRunSnapshot(value) {
-    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)
+    if (!('instruction' in value) || value['instruction'] === undefined)
         return false;
-    if (!('template' in value) || value['template'] === undefined)
+    if (!('inputs' in value) || value['inputs'] === undefined)
         return false;
     return true;
 }
@@ -55,15 +44,10 @@ function WorkflowRunSnapshotFromJSONTyped(json, ignoreDiscriminator) {
         return json;
     }
     return {
-        'workflowDefinitionId': json['workflow_definition_id'],
         'workflowName': json['workflow_name'],
-        'runnerType': (0, WorkflowRunnerType_1.WorkflowRunnerTypeFromJSON)(json['runner_type']),
-        'userId': json['user_id'],
         'maxRunDurationSeconds': json['max_run_duration_seconds'],
-        'sources': (json['sources'].map(ABCDPathSnapshot_1.ABCDPathSnapshotFromJSON)),
-        'instructions': (json['instructions'].map(InstructionSnapshot_1.InstructionSnapshotFromJSON)),
-        'outputs': (json['outputs'].map(ABCDPathSnapshot_1.ABCDPathSnapshotFromJSON)),
-        'template': (0, ABCDPathSnapshot_1.ABCDPathSnapshotFromJSON)(json['template']),
+        'instruction': (0, InstructionSnapshot_1.InstructionSnapshotFromJSON)(json['instruction']),
+        'inputs': (json['inputs'].map(InputSnapshot_1.InputSnapshotFromJSON)),
     };
 }
 function WorkflowRunSnapshotToJSON(json) {
@@ -74,14 +58,9 @@ function WorkflowRunSnapshotToJSONTyped(value, ignoreDiscriminator = false) {
         return value;
     }
     return {
-        'workflow_definition_id': value['workflowDefinitionId'],
         'workflow_name': value['workflowName'],
-        'runner_type': (0, WorkflowRunnerType_1.WorkflowRunnerTypeToJSON)(value['runnerType']),
-        'user_id': value['userId'],
         'max_run_duration_seconds': value['maxRunDurationSeconds'],
-        'sources': (value['sources'].map(ABCDPathSnapshot_1.ABCDPathSnapshotToJSON)),
-        'instructions': (value['instructions'].map(InstructionSnapshot_1.InstructionSnapshotToJSON)),
-        'outputs': (value['outputs'].map(ABCDPathSnapshot_1.ABCDPathSnapshotToJSON)),
-        'template': (0, ABCDPathSnapshot_1.ABCDPathSnapshotToJSON)(value['template']),
+        'instruction': (0, InstructionSnapshot_1.InstructionSnapshotToJSON)(value['instruction']),
+        'inputs': (value['inputs'].map(InputSnapshot_1.InputSnapshotToJSON)),
     };
 }

package/dist/models/XlsxCellAnchorInput.d.ts

@@ -0,0 +1,79 @@
+/**
+ * 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 { CitedChunk } 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 declare const XlsxCellAnchorInputTypeEnum: {
+    readonly XlsxCell: "xlsx_cell";
+};
+export type XlsxCellAnchorInputTypeEnum = typeof XlsxCellAnchorInputTypeEnum[keyof typeof XlsxCellAnchorInputTypeEnum];
+export declare 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;
+    };
+};
+/**
+ * Check if a given object implements the XlsxCellAnchorInput interface.
+ */
+export declare function instanceOfXlsxCellAnchorInput(value: object): value is XlsxCellAnchorInput;
+export declare function XlsxCellAnchorInputFromJSON(json: any): XlsxCellAnchorInput;
+export declare function XlsxCellAnchorInputFromJSONTyped(json: any, ignoreDiscriminator: boolean): XlsxCellAnchorInput;
+export declare function XlsxCellAnchorInputToJSON(json: any): XlsxCellAnchorInput;
+export declare function XlsxCellAnchorInputToJSONTyped(value?: XlsxCellAnchorInput | null, ignoreDiscriminator?: boolean): any;

package/dist/models/XlsxCellAnchorInput.js

@@ -0,0 +1,75 @@
+"use strict";
+/* 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.XlsxCellAnchorInputPropertyValidationAttributesMap = exports.XlsxCellAnchorInputTypeEnum = void 0;
+exports.instanceOfXlsxCellAnchorInput = instanceOfXlsxCellAnchorInput;
+exports.XlsxCellAnchorInputFromJSON = XlsxCellAnchorInputFromJSON;
+exports.XlsxCellAnchorInputFromJSONTyped = XlsxCellAnchorInputFromJSONTyped;
+exports.XlsxCellAnchorInputToJSON = XlsxCellAnchorInputToJSON;
+exports.XlsxCellAnchorInputToJSONTyped = XlsxCellAnchorInputToJSONTyped;
+const CitedChunk_1 = require("./CitedChunk");
+/**
+ * @export
+ */
+exports.XlsxCellAnchorInputTypeEnum = {
+    XlsxCell: 'xlsx_cell'
+};
+exports.XlsxCellAnchorInputPropertyValidationAttributesMap = {
+    anchorText: {
+        maxLength: 160,
+    },
+};
+/**
+ * Check if a given object implements the XlsxCellAnchorInput interface.
+ */
+function instanceOfXlsxCellAnchorInput(value) {
+    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;
+}
+function XlsxCellAnchorInputFromJSON(json) {
+    return XlsxCellAnchorInputFromJSONTyped(json, false);
+}
+function XlsxCellAnchorInputFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    return {
+        'type': json['type'] == null ? undefined : json['type'],
+        'sheetName': json['sheet_name'],
+        'cellAddress': json['cell_address'],
+        'citations': (json['citations'].map(CitedChunk_1.CitedChunkFromJSON)),
+        'anchorText': json['anchor_text'] == null ? undefined : json['anchor_text'],
+    };
+}
+function XlsxCellAnchorInputToJSON(json) {
+    return XlsxCellAnchorInputToJSONTyped(json, false);
+}
+function XlsxCellAnchorInputToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    return {
+        'type': value['type'],
+        'sheet_name': value['sheetName'],
+        'cell_address': value['cellAddress'],
+        'citations': (value['citations'].map(CitedChunk_1.CitedChunkToJSON)),
+        'anchor_text': value['anchorText'],
+    };
+}

package/dist/models/XlsxCellAnchorInputOrDocxParagraphAnchorInput.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 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 type { XlsxCellAnchorInput } from './XlsxCellAnchorInput';
+/**
+ * @type XlsxCellAnchorInputOrDocxParagraphAnchorInput
+ *
+ * @export
+ */
+export type XlsxCellAnchorInputOrDocxParagraphAnchorInput = {
+    type: 'docx_paragraph';
+} & DocxParagraphAnchorInput | {
+    type: 'xlsx_cell';
+} & XlsxCellAnchorInput;
+export declare function XlsxCellAnchorInputOrDocxParagraphAnchorInputFromJSON(json: any): XlsxCellAnchorInputOrDocxParagraphAnchorInput;
+export declare function XlsxCellAnchorInputOrDocxParagraphAnchorInputFromJSONTyped(json: any, ignoreDiscriminator: boolean): XlsxCellAnchorInputOrDocxParagraphAnchorInput;
+export declare function XlsxCellAnchorInputOrDocxParagraphAnchorInputToJSON(json: any): any;
+export declare function XlsxCellAnchorInputOrDocxParagraphAnchorInputToJSONTyped(value?: XlsxCellAnchorInputOrDocxParagraphAnchorInput | null, ignoreDiscriminator?: boolean): any;

package/dist/models/XlsxCellAnchorInputOrDocxParagraphAnchorInput.js

@@ -0,0 +1,53 @@
+"use strict";
+/* 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.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.XlsxCellAnchorInputOrDocxParagraphAnchorInputFromJSON = XlsxCellAnchorInputOrDocxParagraphAnchorInputFromJSON;
+exports.XlsxCellAnchorInputOrDocxParagraphAnchorInputFromJSONTyped = XlsxCellAnchorInputOrDocxParagraphAnchorInputFromJSONTyped;
+exports.XlsxCellAnchorInputOrDocxParagraphAnchorInputToJSON = XlsxCellAnchorInputOrDocxParagraphAnchorInputToJSON;
+exports.XlsxCellAnchorInputOrDocxParagraphAnchorInputToJSONTyped = XlsxCellAnchorInputOrDocxParagraphAnchorInputToJSONTyped;
+const DocxParagraphAnchorInput_1 = require("./DocxParagraphAnchorInput");
+const XlsxCellAnchorInput_1 = require("./XlsxCellAnchorInput");
+function XlsxCellAnchorInputOrDocxParagraphAnchorInputFromJSON(json) {
+    return XlsxCellAnchorInputOrDocxParagraphAnchorInputFromJSONTyped(json, false);
+}
+function XlsxCellAnchorInputOrDocxParagraphAnchorInputFromJSONTyped(json, ignoreDiscriminator) {
+    if (json == null) {
+        return json;
+    }
+    switch (json['type']) {
+        case 'docx_paragraph':
+            return Object.assign({}, (0, DocxParagraphAnchorInput_1.DocxParagraphAnchorInputFromJSONTyped)(json, true), { type: 'docx_paragraph' });
+        case 'xlsx_cell':
+            return Object.assign({}, (0, XlsxCellAnchorInput_1.XlsxCellAnchorInputFromJSONTyped)(json, true), { type: 'xlsx_cell' });
+        default:
+            return json;
+    }
+}
+function XlsxCellAnchorInputOrDocxParagraphAnchorInputToJSON(json) {
+    return XlsxCellAnchorInputOrDocxParagraphAnchorInputToJSONTyped(json, false);
+}
+function XlsxCellAnchorInputOrDocxParagraphAnchorInputToJSONTyped(value, ignoreDiscriminator = false) {
+    if (value == null) {
+        return value;
+    }
+    switch (value['type']) {
+        case 'docx_paragraph':
+            return Object.assign({}, (0, DocxParagraphAnchorInput_1.DocxParagraphAnchorInputToJSON)(value), { type: 'docx_paragraph' });
+        case 'xlsx_cell':
+            return Object.assign({}, (0, XlsxCellAnchorInput_1.XlsxCellAnchorInputToJSON)(value), { type: 'xlsx_cell' });
+        default:
+            return value;
+    }
+}

package/dist/models/XlsxCellAnchorOutput.d.ts

@@ -0,0 +1,90 @@
+/**
+ * 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 { CitedChunk } from './CitedChunk';
+/**
+ * One citation anchored to a cell in an .xlsx deliverable.
+ * @export
+ * @interface XlsxCellAnchorOutput
+ */
+export interface XlsxCellAnchorOutput {
+    /**
+     *
+     * @type {XlsxCellAnchorOutputTypeEnum}
+     * @memberof XlsxCellAnchorOutput
+     */
+    type?: XlsxCellAnchorOutputTypeEnum;
+    /**
+     *
+     * @type {string}
+     * @memberof XlsxCellAnchorOutput
+     */
+    sheetName: string;
+    /**
+     * Coordinate like 'B23'.
+     * @type {string}
+     * @memberof XlsxCellAnchorOutput
+     */
+    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 XlsxCellAnchorOutput
+     */
+    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 XlsxCellAnchorOutput
+     */
+    anchorText?: string;
+    /**
+     * Flat projection of cited chunk_ids — kept for FE back-compat.
+     *
+     * Prefer ``citations`` for new code: each entry already carries the
+     * source-document context the Citations panel needs, no follow-up
+     * ``/v1/chunks/bulk`` call required. Derived-only — ``citations`` is
+     * the single source of truth.
+     * @type {Array<string>}
+     * @memberof XlsxCellAnchorOutput
+     */
+    readonly chunkIds: Array<string>;
+}
+/**
+ * @export
+ */
+export declare const XlsxCellAnchorOutputTypeEnum: {
+    readonly XlsxCell: "xlsx_cell";
+};
+export type XlsxCellAnchorOutputTypeEnum = typeof XlsxCellAnchorOutputTypeEnum[keyof typeof XlsxCellAnchorOutputTypeEnum];
+export declare const XlsxCellAnchorOutputPropertyValidationAttributesMap: {
+    [property: string]: {
+        maxLength?: number;
+        minLength?: number;
+        pattern?: string;
+        maximum?: number;
+        exclusiveMaximum?: boolean;
+        minimum?: number;
+        exclusiveMinimum?: boolean;
+        multipleOf?: number;
+        maxItems?: number;
+        minItems?: number;
+        uniqueItems?: boolean;
+    };
+};
+/**
+ * Check if a given object implements the XlsxCellAnchorOutput interface.
+ */
+export declare function instanceOfXlsxCellAnchorOutput(value: object): value is XlsxCellAnchorOutput;
+export declare function XlsxCellAnchorOutputFromJSON(json: any): XlsxCellAnchorOutput;
+export declare function XlsxCellAnchorOutputFromJSONTyped(json: any, ignoreDiscriminator: boolean): XlsxCellAnchorOutput;
+export declare function XlsxCellAnchorOutputToJSON(json: any): XlsxCellAnchorOutput;
+export declare function XlsxCellAnchorOutputToJSONTyped(value?: Omit<XlsxCellAnchorOutput, 'chunk_ids'> | null, ignoreDiscriminator?: boolean): any;