@knowledge-stack/ksapi 1.83.0 → 1.84.0

package/.openapi-generator/FILES

@@ -9,6 +9,8 @@ docs/AgentApi.md
 docs/AncestryResponse.md
 docs/ApiKeyResponse.md
 docs/ApiKeysApi.md
+docs/AppendEventRequest.md
+docs/AppendMemoryChunkRequest.md
 docs/Args.md
 docs/AskRequest.md
 docs/AskResponse.md
@@ -60,10 +62,12 @@ docs/DocumentVersionMetadataUpdate.md
 docs/DocumentVersionResponse.md
 docs/DocumentVersionsApi.md
 docs/DocumentsApi.md
+docs/EditMemoryChunkRequest.md
 docs/EmailSentResponse.md
 docs/EmailVerificationRequest.md
 docs/EnrichedCitation.md
 docs/EnrichedThreadMessageContent.md
+docs/EventResponse.md
 docs/ExtractRequest.md
 docs/ExtractResponse.md
 docs/FeaturesApi.md
@@ -100,8 +104,11 @@ docs/InvokeWorkflowRequest.md
 docs/LineageEdgeResponse.md
 docs/LineageGraphResponse.md
 docs/LineageNodeResponse.md
+docs/ListMemoryChunksResponse.md
 docs/LocationInner.md
 docs/MembershipResponse.md
+docs/MemoryChunkResponse.md
+docs/MemoryKind.md
 docs/MessageRole.md
 docs/MeteredQuotaStatus.md
 docs/NonFilesystemReferenceType.md
@@ -111,6 +118,7 @@ docs/PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseDiscriminator.
 docs/PaginatedResponseAnnotatedUnionSectionContentItemChunkContentItemDiscriminator.md
 docs/PaginatedResponseDocumentResponse.md
 docs/PaginatedResponseDocumentVersionResponse.md
+docs/PaginatedResponseEventResponse.md
 docs/PaginatedResponseFeedbackEventResponse.md
 docs/PaginatedResponseFolderResponse.md
 docs/PaginatedResponseGroupPermissionResponse.md
@@ -223,6 +231,7 @@ docs/WorkflowCancelResponse.md
 docs/WorkflowDefinitionResponse.md
 docs/WorkflowDefinitionsApi.md
 docs/WorkflowDetailResponse.md
+docs/WorkflowMemoryApi.md
 docs/WorkflowRunCallbackRequest.md
 docs/WorkflowRunResponse.md
 docs/WorkflowRunSnapshot.md
@@ -256,6 +265,7 @@ src/apis/ThreadsApi.ts
 src/apis/UserPermissionsApi.ts
 src/apis/UsersApi.ts
 src/apis/WorkflowDefinitionsApi.ts
+src/apis/WorkflowMemoryApi.ts
 src/apis/WorkflowRunsApi.ts
 src/apis/WorkflowsApi.ts
 src/apis/index.ts
@@ -265,6 +275,8 @@ src/models/AcceptInviteResponse.ts
 src/models/AddMemberRequest.ts
 src/models/AncestryResponse.ts
 src/models/ApiKeyResponse.ts
+src/models/AppendEventRequest.ts
+src/models/AppendMemoryChunkRequest.ts
 src/models/Args.ts
 src/models/AskRequest.ts
 src/models/AskResponse.ts
@@ -310,10 +322,12 @@ src/models/DocumentVersionContentTypeFilter.ts
 src/models/DocumentVersionMetadata.ts
 src/models/DocumentVersionMetadataUpdate.ts
 src/models/DocumentVersionResponse.ts
+src/models/EditMemoryChunkRequest.ts
 src/models/EmailSentResponse.ts
 src/models/EmailVerificationRequest.ts
 src/models/EnrichedCitation.ts
 src/models/EnrichedThreadMessageContent.ts
+src/models/EventResponse.ts
 src/models/ExtractRequest.ts
 src/models/ExtractResponse.ts
 src/models/FeaturesResponse.ts
@@ -346,8 +360,11 @@ src/models/InvokeWorkflowRequest.ts
 src/models/LineageEdgeResponse.ts
 src/models/LineageGraphResponse.ts
 src/models/LineageNodeResponse.ts
+src/models/ListMemoryChunksResponse.ts
 src/models/LocationInner.ts
 src/models/MembershipResponse.ts
+src/models/MemoryChunkResponse.ts
+src/models/MemoryKind.ts
 src/models/MessageRole.ts
 src/models/MeteredQuotaStatus.ts
 src/models/NonFilesystemReferenceType.ts
@@ -357,6 +374,7 @@ src/models/PaginatedResponseAnnotatedUnionFolderResponseDocumentResponseDiscrimi
 src/models/PaginatedResponseAnnotatedUnionSectionContentItemChunkContentItemDiscriminator.ts
 src/models/PaginatedResponseDocumentResponse.ts
 src/models/PaginatedResponseDocumentVersionResponse.ts
+src/models/PaginatedResponseEventResponse.ts
 src/models/PaginatedResponseFeedbackEventResponse.ts
 src/models/PaginatedResponseFolderResponse.ts
 src/models/PaginatedResponseGroupPermissionResponse.ts

package/README.md

@@ -1,4 +1,4 @@
-# @knowledge-stack/ksapi@1.83.0
+# @knowledge-stack/ksapi@1.84.0
 
 A TypeScript SDK client for the localhost API.
 
@@ -119,11 +119,13 @@ All URIs are relative to *http://localhost:8000*
 *InvitesApi* | [**deleteInvite**](docs/InvitesApi.md#deleteinvite) | **DELETE** /v1/invites/{invite_id} | Delete Invite
 *InvitesApi* | [**listInvites**](docs/InvitesApi.md#listinvites) | **GET** /v1/invites | List Invites Handler
 *InvitesApi* | [**updateInvite**](docs/InvitesApi.md#updateinviteoperation) | **PATCH** /v1/invites/{invite_id} | Update Invite Handler
+*PathPartsApi* | [**appendPathPartEvent**](docs/PathPartsApi.md#appendpathpartevent) | **POST** /v1/path-parts/{path_part_id}/events | Append Path Part Event Handler
 *PathPartsApi* | [**bulkRemovePathPartTags**](docs/PathPartsApi.md#bulkremovepathparttags) | **DELETE** /v1/path-parts/{path_part_id}/tags | Bulk Remove Path Part Tags Handler
 *PathPartsApi* | [**getPathPart**](docs/PathPartsApi.md#getpathpart) | **GET** /v1/path-parts/{path_part_id} | Get Path Part Handler
 *PathPartsApi* | [**getPathPartAncestry**](docs/PathPartsApi.md#getpathpartancestry) | **GET** /v1/path-parts/{path_part_id}/ancestry | Get Path Part Ancestry Handler
 *PathPartsApi* | [**getPathPartSubtreeChunks**](docs/PathPartsApi.md#getpathpartsubtreechunks) | **GET** /v1/path-parts/{path_part_id}/subtree_chunks | Get Path Part Subtree Chunks Handler
 *PathPartsApi* | [**getPathPartTags**](docs/PathPartsApi.md#getpathparttags) | **GET** /v1/path-parts/{path_part_id}/tags | Get Path Part Tags Handler
+*PathPartsApi* | [**listPathPartEvents**](docs/PathPartsApi.md#listpathpartevents) | **GET** /v1/path-parts/{path_part_id}/events | List Path Part Events Handler
 *PathPartsApi* | [**listPathParts**](docs/PathPartsApi.md#listpathparts) | **GET** /v1/path-parts | List Path Parts Handler
 *PathPartsApi* | [**setPathPartTags**](docs/PathPartsApi.md#setpathparttags) | **POST** /v1/path-parts/{path_part_id}/tags | Set Path Part Tags Handler
 *PublicApi* | [**listPublicSubscriptions**](docs/PublicApi.md#listpublicsubscriptions) | **GET** /public/subscriptions | List Public Subscriptions Handler
@@ -191,6 +193,11 @@ All URIs are relative to *http://localhost:8000*
 *WorkflowDefinitionsApi* | [**listWorkflowDefinitions**](docs/WorkflowDefinitionsApi.md#listworkflowdefinitions) | **GET** /v1/workflow-definitions | List Workflow Definitions Handler
 *WorkflowDefinitionsApi* | [**listWorkflowRuns**](docs/WorkflowDefinitionsApi.md#listworkflowruns) | **GET** /v1/workflow-definitions/{definition_id}/runs | List Workflow Runs Handler
 *WorkflowDefinitionsApi* | [**updateWorkflowDefinition**](docs/WorkflowDefinitionsApi.md#updateworkflowdefinitionoperation) | **PUT** /v1/workflow-definitions/{definition_id} | Update Workflow Definition Handler
+*WorkflowMemoryApi* | [**appendWorkflowMemoryChunk**](docs/WorkflowMemoryApi.md#appendworkflowmemorychunk) | **POST** /v1/workflow-definitions/{definition_id}/memory/chunks | Append Workflow Memory Chunk Handler
+*WorkflowMemoryApi* | [**editWorkflowMemoryChunk**](docs/WorkflowMemoryApi.md#editworkflowmemorychunk) | **PATCH** /v1/workflow-definitions/{definition_id}/memory/chunks/{chunk_id} | Edit Workflow Memory Chunk Handler
+*WorkflowMemoryApi* | [**forgetWorkflowMemoryChunk**](docs/WorkflowMemoryApi.md#forgetworkflowmemorychunk) | **DELETE** /v1/workflow-definitions/{definition_id}/memory/chunks/{chunk_id} | Forget Workflow Memory Chunk Handler
+*WorkflowMemoryApi* | [**getWorkflowMemoryChunk**](docs/WorkflowMemoryApi.md#getworkflowmemorychunk) | **GET** /v1/workflow-definitions/{definition_id}/memory/chunks/{chunk_id} | Get Workflow Memory Chunk Handler
+*WorkflowMemoryApi* | [**listWorkflowMemoryChunks**](docs/WorkflowMemoryApi.md#listworkflowmemorychunks) | **GET** /v1/workflow-definitions/{definition_id}/memory | List Workflow Memory Chunks Handler
 *WorkflowRunsApi* | [**acquireWorkflowRunLock**](docs/WorkflowRunsApi.md#acquireworkflowrunlock) | **POST** /v1/workflow-runs/{run_id}/lock | Acquire Workflow Run Lock Handler
 *WorkflowRunsApi* | [**approveWorkflowRunFile**](docs/WorkflowRunsApi.md#approveworkflowrunfile) | **POST** /v1/workflow-runs/{run_id}/files/{path_part_id}/approve | Approve Workflow Run File Handler
 *WorkflowRunsApi* | [**deleteWorkflowRun**](docs/WorkflowRunsApi.md#deleteworkflowrun) | **DELETE** /v1/workflow-runs/{run_id} | Delete Workflow Run Handler
@@ -213,6 +220,8 @@ All URIs are relative to *http://localhost:8000*
 - [AddMemberRequest](docs/AddMemberRequest.md)
 - [AncestryResponse](docs/AncestryResponse.md)
 - [ApiKeyResponse](docs/ApiKeyResponse.md)
+- [AppendEventRequest](docs/AppendEventRequest.md)
+- [AppendMemoryChunkRequest](docs/AppendMemoryChunkRequest.md)
 - [Args](docs/Args.md)
 - [AskRequest](docs/AskRequest.md)
 - [AskResponse](docs/AskResponse.md)
@@ -258,10 +267,12 @@ All URIs are relative to *http://localhost:8000*
 - [DocumentVersionMetadata](docs/DocumentVersionMetadata.md)
 - [DocumentVersionMetadataUpdate](docs/DocumentVersionMetadataUpdate.md)
 - [DocumentVersionResponse](docs/DocumentVersionResponse.md)
+- [EditMemoryChunkRequest](docs/EditMemoryChunkRequest.md)
 - [EmailSentResponse](docs/EmailSentResponse.md)
 - [EmailVerificationRequest](docs/EmailVerificationRequest.md)
 - [EnrichedCitation](docs/EnrichedCitation.md)
 - [EnrichedThreadMessageContent](docs/EnrichedThreadMessageContent.md)
+- [EventResponse](docs/EventResponse.md)
 - [ExtractRequest](docs/ExtractRequest.md)
 - [ExtractResponse](docs/ExtractResponse.md)
 - [FeaturesResponse](docs/FeaturesResponse.md)
@@ -294,8 +305,11 @@ All URIs are relative to *http://localhost:8000*
 - [LineageEdgeResponse](docs/LineageEdgeResponse.md)
 - [LineageGraphResponse](docs/LineageGraphResponse.md)
 - [LineageNodeResponse](docs/LineageNodeResponse.md)
+- [ListMemoryChunksResponse](docs/ListMemoryChunksResponse.md)
 - [LocationInner](docs/LocationInner.md)
 - [MembershipResponse](docs/MembershipResponse.md)
+- [MemoryChunkResponse](docs/MemoryChunkResponse.md)
+- [MemoryKind](docs/MemoryKind.md)
 - [MessageRole](docs/MessageRole.md)
 - [MeteredQuotaStatus](docs/MeteredQuotaStatus.md)
 - [NonFilesystemReferenceType](docs/NonFilesystemReferenceType.md)
@@ -305,6 +319,7 @@ All URIs are relative to *http://localhost:8000*
 - [PaginatedResponseAnnotatedUnionSectionContentItemChunkContentItemDiscriminator](docs/PaginatedResponseAnnotatedUnionSectionContentItemChunkContentItemDiscriminator.md)
 - [PaginatedResponseDocumentResponse](docs/PaginatedResponseDocumentResponse.md)
 - [PaginatedResponseDocumentVersionResponse](docs/PaginatedResponseDocumentVersionResponse.md)
+- [PaginatedResponseEventResponse](docs/PaginatedResponseEventResponse.md)
 - [PaginatedResponseFeedbackEventResponse](docs/PaginatedResponseFeedbackEventResponse.md)
 - [PaginatedResponseFolderResponse](docs/PaginatedResponseFolderResponse.md)
 - [PaginatedResponseGroupPermissionResponse](docs/PaginatedResponseGroupPermissionResponse.md)
@@ -424,7 +439,7 @@ and is automatically generated by the
 [OpenAPI Generator](https://openapi-generator.tech) project:
 
 - API version: `0.1.0`
-- Package version: `1.83.0`
+- Package version: `1.84.0`
 - Generator version: `7.21.0`
 - Build package: `org.openapitools.codegen.languages.TypeScriptFetchClientCodegen`
 

package/dist/apis/PathPartsApi.d.ts

@@ -10,7 +10,13 @@
  * Do not edit the class manually.
  */
 import * as runtime from '../runtime';
-import type { AncestryResponse, BulkTagRequest, PaginatedResponsePathPartResponse, PathOrder, PathPartResponse, PathPartTagsResponse, SubtreeChunksResponse } from '../models/index';
+import type { AncestryResponse, AppendEventRequest, BulkTagRequest, EventResponse, PaginatedResponseEventResponse, PaginatedResponsePathPartResponse, PathOrder, PathPartResponse, PathPartTagsResponse, SubtreeChunksResponse } from '../models/index';
+export interface AppendPathPartEventRequest {
+    pathPartId: string;
+    appendEventRequest: AppendEventRequest;
+    authorization?: string | null;
+    ksUat?: string | null;
+}
 export interface BulkRemovePathPartTagsRequest {
     pathPartId: string;
     bulkTagRequest: BulkTagRequest;
@@ -38,6 +44,17 @@ export interface GetPathPartTagsRequest {
     authorization?: string | null;
     ksUat?: string | null;
 }
+export interface ListPathPartEventsRequest {
+    pathPartId: string;
+    kind?: string | null;
+    since?: Date | null;
+    until?: Date | null;
+    recursive?: boolean;
+    limit?: number;
+    offset?: number;
+    authorization?: string | null;
+    ksUat?: string | null;
+}
 export interface ListPathPartsRequest {
     parentPathId?: string | null;
     maxDepth?: number;
@@ -60,6 +77,33 @@ export interface SetPathPartTagsRequest {
  * @interface PathPartsApiInterface
  */
 export interface PathPartsApiInterface {
+    /**
+     * Creates request options for appendPathPartEvent without sending the request
+     * @param {string} pathPartId
+     * @param {AppendEventRequest} appendEventRequest
+     * @param {string} [authorization]
+     * @param {string} [ksUat]
+     * @throws {RequiredError}
+     * @memberof PathPartsApiInterface
+     */
+    appendPathPartEventRequestOpts(requestParameters: AppendPathPartEventRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Record an event for a subject path_part from the frontend.  Auth: caller must hold ``can_write`` on the subject\'s materialized_path (OWNER/ADMIN bypass). Server stamps ``actor_user_id`` from the caller\'s identity — callers cannot impersonate other users on the audit trail.  ``kind`` is free-form text but reserved server namespaces (``workflow.``, ``document.``, ``folder.``, ``permission.``, ``connector.``, ``query.``, ``auth.``, ``tenant.``) are rejected at 422 so clients cannot forge server-emitted audit events. Clients should namespace under ``client.*``. ``payload`` is capped at 64KB encoded JSON.
+     * @summary Append Path Part Event Handler
+     * @param {string} pathPartId
+     * @param {AppendEventRequest} appendEventRequest
+     * @param {string} [authorization]
+     * @param {string} [ksUat]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof PathPartsApiInterface
+     */
+    appendPathPartEventRaw(requestParameters: AppendPathPartEventRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<EventResponse>>;
+    /**
+     * Record an event for a subject path_part from the frontend.  Auth: caller must hold ``can_write`` on the subject\'s materialized_path (OWNER/ADMIN bypass). Server stamps ``actor_user_id`` from the caller\'s identity — callers cannot impersonate other users on the audit trail.  ``kind`` is free-form text but reserved server namespaces (``workflow.``, ``document.``, ``folder.``, ``permission.``, ``connector.``, ``query.``, ``auth.``, ``tenant.``) are rejected at 422 so clients cannot forge server-emitted audit events. Clients should namespace under ``client.*``. ``payload`` is capped at 64KB encoded JSON.
+     * Append Path Part Event Handler
+     */
+    appendPathPartEvent(requestParameters: AppendPathPartEventRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<EventResponse>;
     /**
      * Creates request options for bulkRemovePathPartTags without sending the request
      * @param {string} pathPartId
@@ -189,6 +233,43 @@ export interface PathPartsApiInterface {
      * Get Path Part Tags Handler
      */
     getPathPartTags(requestParameters: GetPathPartTagsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PathPartTagsResponse>;
+    /**
+     * Creates request options for listPathPartEvents without sending the request
+     * @param {string} pathPartId
+     * @param {string} [kind] Filter to a single event kind
+     * @param {Date} [since] Only events at or after this timestamp
+     * @param {Date} [until] Only events strictly before this timestamp
+     * @param {boolean} [recursive] Include events from descendant path_parts as well as the subject itself
+     * @param {number} [limit] Number of items per page
+     * @param {number} [offset] Number of items to skip
+     * @param {string} [authorization]
+     * @param {string} [ksUat]
+     * @throws {RequiredError}
+     * @memberof PathPartsApiInterface
+     */
+    listPathPartEventsRequestOpts(requestParameters: ListPathPartEventsRequest): Promise<runtime.RequestOpts>;
+    /**
+     * List events anchored to a specific path_part subject.  Subject permission is enforced via the existing ``PathPermissionService`` — caller must have ``can_read`` on the subject\'s materialized_path (OWNER/ADMIN bypass). Events are ordered newest-first by ``ts`` and paginated.  When ``recursive=True``, events on any descendant of the subject are included — useful for \"all events under this folder\" or \"all events under this workflow definition\".
+     * @summary List Path Part Events Handler
+     * @param {string} pathPartId
+     * @param {string} [kind] Filter to a single event kind
+     * @param {Date} [since] Only events at or after this timestamp
+     * @param {Date} [until] Only events strictly before this timestamp
+     * @param {boolean} [recursive] Include events from descendant path_parts as well as the subject itself
+     * @param {number} [limit] Number of items per page
+     * @param {number} [offset] Number of items to skip
+     * @param {string} [authorization]
+     * @param {string} [ksUat]
+     * @param {*} [options] Override http request option.
+     * @throws {RequiredError}
+     * @memberof PathPartsApiInterface
+     */
+    listPathPartEventsRaw(requestParameters: ListPathPartEventsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseEventResponse>>;
+    /**
+     * List events anchored to a specific path_part subject.  Subject permission is enforced via the existing ``PathPermissionService`` — caller must have ``can_read`` on the subject\'s materialized_path (OWNER/ADMIN bypass). Events are ordered newest-first by ``ts`` and paginated.  When ``recursive=True``, events on any descendant of the subject are included — useful for \"all events under this folder\" or \"all events under this workflow definition\".
+     * List Path Part Events Handler
+     */
+    listPathPartEvents(requestParameters: ListPathPartEventsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseEventResponse>;
     /**
      * Creates request options for listPathParts without sending the request
      * @param {string} [parentPathId] Parent PathPart ID (defaults to root)
@@ -254,6 +335,20 @@ export interface PathPartsApiInterface {
  *
  */
 export declare class PathPartsApi extends runtime.BaseAPI implements PathPartsApiInterface {
+    /**
+     * Creates request options for appendPathPartEvent without sending the request
+     */
+    appendPathPartEventRequestOpts(requestParameters: AppendPathPartEventRequest): Promise<runtime.RequestOpts>;
+    /**
+     * Record an event for a subject path_part from the frontend.  Auth: caller must hold ``can_write`` on the subject\'s materialized_path (OWNER/ADMIN bypass). Server stamps ``actor_user_id`` from the caller\'s identity — callers cannot impersonate other users on the audit trail.  ``kind`` is free-form text but reserved server namespaces (``workflow.``, ``document.``, ``folder.``, ``permission.``, ``connector.``, ``query.``, ``auth.``, ``tenant.``) are rejected at 422 so clients cannot forge server-emitted audit events. Clients should namespace under ``client.*``. ``payload`` is capped at 64KB encoded JSON.
+     * Append Path Part Event Handler
+     */
+    appendPathPartEventRaw(requestParameters: AppendPathPartEventRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<EventResponse>>;
+    /**
+     * Record an event for a subject path_part from the frontend.  Auth: caller must hold ``can_write`` on the subject\'s materialized_path (OWNER/ADMIN bypass). Server stamps ``actor_user_id`` from the caller\'s identity — callers cannot impersonate other users on the audit trail.  ``kind`` is free-form text but reserved server namespaces (``workflow.``, ``document.``, ``folder.``, ``permission.``, ``connector.``, ``query.``, ``auth.``, ``tenant.``) are rejected at 422 so clients cannot forge server-emitted audit events. Clients should namespace under ``client.*``. ``payload`` is capped at 64KB encoded JSON.
+     * Append Path Part Event Handler
+     */
+    appendPathPartEvent(requestParameters: AppendPathPartEventRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<EventResponse>;
     /**
      * Creates request options for bulkRemovePathPartTags without sending the request
      */
@@ -324,6 +419,20 @@ export declare class PathPartsApi extends runtime.BaseAPI implements PathPartsAp
      * Get Path Part Tags Handler
      */
     getPathPartTags(requestParameters: GetPathPartTagsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PathPartTagsResponse>;
+    /**
+     * Creates request options for listPathPartEvents without sending the request
+     */
+    listPathPartEventsRequestOpts(requestParameters: ListPathPartEventsRequest): Promise<runtime.RequestOpts>;
+    /**
+     * List events anchored to a specific path_part subject.  Subject permission is enforced via the existing ``PathPermissionService`` — caller must have ``can_read`` on the subject\'s materialized_path (OWNER/ADMIN bypass). Events are ordered newest-first by ``ts`` and paginated.  When ``recursive=True``, events on any descendant of the subject are included — useful for \"all events under this folder\" or \"all events under this workflow definition\".
+     * List Path Part Events Handler
+     */
+    listPathPartEventsRaw(requestParameters: ListPathPartEventsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<runtime.ApiResponse<PaginatedResponseEventResponse>>;
+    /**
+     * List events anchored to a specific path_part subject.  Subject permission is enforced via the existing ``PathPermissionService`` — caller must have ``can_read`` on the subject\'s materialized_path (OWNER/ADMIN bypass). Events are ordered newest-first by ``ts`` and paginated.  When ``recursive=True``, events on any descendant of the subject are included — useful for \"all events under this folder\" or \"all events under this workflow definition\".
+     * List Path Part Events Handler
+     */
+    listPathPartEvents(requestParameters: ListPathPartEventsRequest, initOverrides?: RequestInit | runtime.InitOverrideFunction): Promise<PaginatedResponseEventResponse>;
     /**
      * Creates request options for listPathParts without sending the request
      */

package/dist/apis/PathPartsApi.js

@@ -62,6 +62,55 @@ const index_1 = require("../models/index");
  *
  */
 class PathPartsApi extends runtime.BaseAPI {
+    /**
+     * Creates request options for appendPathPartEvent without sending the request
+     */
+    appendPathPartEventRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['pathPartId'] == null) {
+                throw new runtime.RequiredError('pathPartId', 'Required parameter "pathPartId" was null or undefined when calling appendPathPartEvent().');
+            }
+            if (requestParameters['appendEventRequest'] == null) {
+                throw new runtime.RequiredError('appendEventRequest', 'Required parameter "appendEventRequest" was null or undefined when calling appendPathPartEvent().');
+            }
+            const queryParameters = {};
+            const headerParameters = {};
+            headerParameters['Content-Type'] = 'application/json';
+            if (requestParameters['authorization'] != null) {
+                headerParameters['authorization'] = String(requestParameters['authorization']);
+            }
+            let urlPath = `/v1/path-parts/{path_part_id}/events`;
+            urlPath = urlPath.replace(`{${"path_part_id"}}`, encodeURIComponent(String(requestParameters['pathPartId'])));
+            return {
+                path: urlPath,
+                method: 'POST',
+                headers: headerParameters,
+                query: queryParameters,
+                body: (0, index_1.AppendEventRequestToJSON)(requestParameters['appendEventRequest']),
+            };
+        });
+    }
+    /**
+     * Record an event for a subject path_part from the frontend.  Auth: caller must hold ``can_write`` on the subject\'s materialized_path (OWNER/ADMIN bypass). Server stamps ``actor_user_id`` from the caller\'s identity — callers cannot impersonate other users on the audit trail.  ``kind`` is free-form text but reserved server namespaces (``workflow.``, ``document.``, ``folder.``, ``permission.``, ``connector.``, ``query.``, ``auth.``, ``tenant.``) are rejected at 422 so clients cannot forge server-emitted audit events. Clients should namespace under ``client.*``. ``payload`` is capped at 64KB encoded JSON.
+     * Append Path Part Event Handler
+     */
+    appendPathPartEventRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.appendPathPartEventRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.EventResponseFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * Record an event for a subject path_part from the frontend.  Auth: caller must hold ``can_write`` on the subject\'s materialized_path (OWNER/ADMIN bypass). Server stamps ``actor_user_id`` from the caller\'s identity — callers cannot impersonate other users on the audit trail.  ``kind`` is free-form text but reserved server namespaces (``workflow.``, ``document.``, ``folder.``, ``permission.``, ``connector.``, ``query.``, ``auth.``, ``tenant.``) are rejected at 422 so clients cannot forge server-emitted audit events. Clients should namespace under ``client.*``. ``payload`` is capped at 64KB encoded JSON.
+     * Append Path Part Event Handler
+     */
+    appendPathPartEvent(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.appendPathPartEventRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Creates request options for bulkRemovePathPartTags without sending the request
      */
@@ -290,6 +339,68 @@ class PathPartsApi extends runtime.BaseAPI {
             return yield response.value();
         });
     }
+    /**
+     * Creates request options for listPathPartEvents without sending the request
+     */
+    listPathPartEventsRequestOpts(requestParameters) {
+        return __awaiter(this, void 0, void 0, function* () {
+            if (requestParameters['pathPartId'] == null) {
+                throw new runtime.RequiredError('pathPartId', 'Required parameter "pathPartId" was null or undefined when calling listPathPartEvents().');
+            }
+            const queryParameters = {};
+            if (requestParameters['kind'] != null) {
+                queryParameters['kind'] = requestParameters['kind'];
+            }
+            if (requestParameters['since'] != null) {
+                queryParameters['since'] = requestParameters['since'].toISOString();
+            }
+            if (requestParameters['until'] != null) {
+                queryParameters['until'] = requestParameters['until'].toISOString();
+            }
+            if (requestParameters['recursive'] != null) {
+                queryParameters['recursive'] = requestParameters['recursive'];
+            }
+            if (requestParameters['limit'] != null) {
+                queryParameters['limit'] = requestParameters['limit'];
+            }
+            if (requestParameters['offset'] != null) {
+                queryParameters['offset'] = requestParameters['offset'];
+            }
+            const headerParameters = {};
+            if (requestParameters['authorization'] != null) {
+                headerParameters['authorization'] = String(requestParameters['authorization']);
+            }
+            let urlPath = `/v1/path-parts/{path_part_id}/events`;
+            urlPath = urlPath.replace(`{${"path_part_id"}}`, encodeURIComponent(String(requestParameters['pathPartId'])));
+            return {
+                path: urlPath,
+                method: 'GET',
+                headers: headerParameters,
+                query: queryParameters,
+            };
+        });
+    }
+    /**
+     * List events anchored to a specific path_part subject.  Subject permission is enforced via the existing ``PathPermissionService`` — caller must have ``can_read`` on the subject\'s materialized_path (OWNER/ADMIN bypass). Events are ordered newest-first by ``ts`` and paginated.  When ``recursive=True``, events on any descendant of the subject are included — useful for \"all events under this folder\" or \"all events under this workflow definition\".
+     * List Path Part Events Handler
+     */
+    listPathPartEventsRaw(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const requestOptions = yield this.listPathPartEventsRequestOpts(requestParameters);
+            const response = yield this.request(requestOptions, initOverrides);
+            return new runtime.JSONApiResponse(response, (jsonValue) => (0, index_1.PaginatedResponseEventResponseFromJSON)(jsonValue));
+        });
+    }
+    /**
+     * List events anchored to a specific path_part subject.  Subject permission is enforced via the existing ``PathPermissionService`` — caller must have ``can_read`` on the subject\'s materialized_path (OWNER/ADMIN bypass). Events are ordered newest-first by ``ts`` and paginated.  When ``recursive=True``, events on any descendant of the subject are included — useful for \"all events under this folder\" or \"all events under this workflow definition\".
+     * List Path Part Events Handler
+     */
+    listPathPartEvents(requestParameters, initOverrides) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const response = yield this.listPathPartEventsRaw(requestParameters, initOverrides);
+            return yield response.value();
+        });
+    }
     /**
      * Creates request options for listPathParts without sending the request
      */