@raisindb/client 0.2.5 → 0.2.6

package/dist/{conversation-list-store-S5MPSqoB.d.mts → conversation-list-store-CU5mi_PE.d.mts}

@@ -1203,12 +1203,29 @@ declare class NodeOperations {
      */
     getChildrenByPath(parentPath: string, limit?: number): Promise<Node[]>;
     /**
-     * List children of a parent node
+     * List children of a parent node, in editorial (drag-and-drop) order.
      *
      * @param parentPath - Path of the parent node
      * @returns Array of child nodes
      */
     listChildren(parentPath: string): Promise<Node[]>;
+    /**
+     * List one page of a parent's children, in editorial order.
+     *
+     * Pagination is keyset-based: pass the previous response's `nextCursor` back as
+     * `cursor` to get the following page. `nextCursor` is `null` on the last page.
+     * Treat the cursor as opaque — do not parse or construct it.
+     *
+     * @param parentPath - Path of the parent node
+     * @param options - `cursor` from a previous page, and page `limit`
+     */
+    listChildrenPage(parentPath: string, options?: {
+        cursor?: string;
+        limit?: number;
+    }): Promise<{
+        items: Node[];
+        nextCursor: string | null;
+    }>;
     /**
      * Get a node tree starting from a root node
      *
@@ -1260,31 +1277,33 @@ declare class NodeOperations {
      */
     copyTree(fromPath: string, toParentPath: string, newName?: string): Promise<Node>;
     /**
-     * Reorder a node by setting a new order key
+     * Move a child to a specific position among its siblings.
      *
-     * @param nodePath - Node path
-     * @param orderKey - New order key (base62-encoded fractional index)
-     * @returns Reordered node
+     * Positions are 0-based; a position past the end appends. The server owns the
+     * fractional order key — you name a position, it mints the key.
+     *
+     * @param parentPath - Parent node path
+     * @param childName - Name of the child to move (not a full path)
+     * @param position - Target 0-based position among the parent's children
+     * @returns The reordered node, carrying its newly assigned `order_key`
      */
-    reorder(nodePath: string, orderKey: string): Promise<Node>;
+    reorder(parentPath: string, childName: string, position: number): Promise<Node>;
     /**
-     * Move a child node before a reference sibling
+     * Move a child so it sits immediately before one of its siblings.
      *
      * @param parentPath - Parent node path
-     * @param childPath - Child node path to move
-     * @param referencePath - Reference sibling path to position before
-     * @returns Moved node
+     * @param childName - Name of the child to move (not a full path)
+     * @param beforeChildName - Name of the sibling to sit before
      */
-    moveChildBefore(parentPath: string, childPath: string, referencePath: string): Promise<Node>;
+    moveChildBefore(parentPath: string, childName: string, beforeChildName: string): Promise<void>;
     /**
-     * Move a child node after a reference sibling
+     * Move a child so it sits immediately after one of its siblings.
      *
      * @param parentPath - Parent node path
-     * @param childPath - Child node path to move
-     * @param referencePath - Reference sibling path to position after
-     * @returns Moved node
+     * @param childName - Name of the child to move (not a full path)
+     * @param afterChildName - Name of the sibling to sit after
      */
-    moveChildAfter(parentPath: string, childPath: string, referencePath: string): Promise<Node>;
+    moveChildAfter(parentPath: string, childName: string, afterChildName: string): Promise<void>;
     /**
      * Replay a parent's child order from another branch onto the current branch.
      *

package/dist/{conversation-list-store-S5MPSqoB.d.ts → conversation-list-store-CU5mi_PE.d.ts}

@@ -1203,12 +1203,29 @@ declare class NodeOperations {
      */
     getChildrenByPath(parentPath: string, limit?: number): Promise<Node[]>;
     /**
-     * List children of a parent node
+     * List children of a parent node, in editorial (drag-and-drop) order.
      *
      * @param parentPath - Path of the parent node
      * @returns Array of child nodes
      */
     listChildren(parentPath: string): Promise<Node[]>;
+    /**
+     * List one page of a parent's children, in editorial order.
+     *
+     * Pagination is keyset-based: pass the previous response's `nextCursor` back as
+     * `cursor` to get the following page. `nextCursor` is `null` on the last page.
+     * Treat the cursor as opaque — do not parse or construct it.
+     *
+     * @param parentPath - Path of the parent node
+     * @param options - `cursor` from a previous page, and page `limit`
+     */
+    listChildrenPage(parentPath: string, options?: {
+        cursor?: string;
+        limit?: number;
+    }): Promise<{
+        items: Node[];
+        nextCursor: string | null;
+    }>;
     /**
      * Get a node tree starting from a root node
      *
@@ -1260,31 +1277,33 @@ declare class NodeOperations {
      */
     copyTree(fromPath: string, toParentPath: string, newName?: string): Promise<Node>;
     /**
-     * Reorder a node by setting a new order key
+     * Move a child to a specific position among its siblings.
      *
-     * @param nodePath - Node path
-     * @param orderKey - New order key (base62-encoded fractional index)
-     * @returns Reordered node
+     * Positions are 0-based; a position past the end appends. The server owns the
+     * fractional order key — you name a position, it mints the key.
+     *
+     * @param parentPath - Parent node path
+     * @param childName - Name of the child to move (not a full path)
+     * @param position - Target 0-based position among the parent's children
+     * @returns The reordered node, carrying its newly assigned `order_key`
      */
-    reorder(nodePath: string, orderKey: string): Promise<Node>;
+    reorder(parentPath: string, childName: string, position: number): Promise<Node>;
     /**
-     * Move a child node before a reference sibling
+     * Move a child so it sits immediately before one of its siblings.
      *
      * @param parentPath - Parent node path
-     * @param childPath - Child node path to move
-     * @param referencePath - Reference sibling path to position before
-     * @returns Moved node
+     * @param childName - Name of the child to move (not a full path)
+     * @param beforeChildName - Name of the sibling to sit before
      */
-    moveChildBefore(parentPath: string, childPath: string, referencePath: string): Promise<Node>;
+    moveChildBefore(parentPath: string, childName: string, beforeChildName: string): Promise<void>;
     /**
-     * Move a child node after a reference sibling
+     * Move a child so it sits immediately after one of its siblings.
      *
      * @param parentPath - Parent node path
-     * @param childPath - Child node path to move
-     * @param referencePath - Reference sibling path to position after
-     * @returns Moved node
+     * @param childName - Name of the child to move (not a full path)
+     * @param afterChildName - Name of the sibling to sit after
      */
-    moveChildAfter(parentPath: string, childPath: string, referencePath: string): Promise<Node>;
+    moveChildAfter(parentPath: string, childName: string, afterChildName: string): Promise<void>;
     /**
      * Replay a parent's child order from another branch onto the current branch.
      *

package/dist/{index-3-fS4i8b.d.mts → index-DDus5a7P.d.mts}

@@ -1,4 +1,4 @@
-import { f as ConversationStoreOptions, a as ConversationStoreSnapshot, b as ChatMessage, g as ConversationListStoreOptions, h as ConversationListSnapshot, d as ConversationListItem, R as RaisinClient, I as IdentityUser, C as ConnectionState, S as SubscriptionFilters, D as Database, A as AuthManager, F as FlowClientOptions, i as FlowsApi, j as FlowExecutionEvent, E as EventMessage } from './conversation-list-store-S5MPSqoB.mjs';
+import { f as ConversationStoreOptions, a as ConversationStoreSnapshot, b as ChatMessage, g as ConversationListStoreOptions, h as ConversationListSnapshot, d as ConversationListItem, R as RaisinClient, I as IdentityUser, C as ConnectionState, S as SubscriptionFilters, D as Database, A as AuthManager, F as FlowClientOptions, i as FlowsApi, j as FlowExecutionEvent, E as EventMessage } from './conversation-list-store-CU5mi_PE.mjs';
 
 /**
  * React adapters for the RaisinDB conversation stores.

package/dist/{index-Bs7UkpRs.d.ts → index-sFvMihQA.d.ts}

@@ -1,4 +1,4 @@
-import { f as ConversationStoreOptions, a as ConversationStoreSnapshot, b as ChatMessage, g as ConversationListStoreOptions, h as ConversationListSnapshot, d as ConversationListItem, R as RaisinClient, I as IdentityUser, C as ConnectionState, S as SubscriptionFilters, D as Database, A as AuthManager, F as FlowClientOptions, i as FlowsApi, j as FlowExecutionEvent, E as EventMessage } from './conversation-list-store-S5MPSqoB.js';
+import { f as ConversationStoreOptions, a as ConversationStoreSnapshot, b as ChatMessage, g as ConversationListStoreOptions, h as ConversationListSnapshot, d as ConversationListItem, R as RaisinClient, I as IdentityUser, C as ConnectionState, S as SubscriptionFilters, D as Database, A as AuthManager, F as FlowClientOptions, i as FlowsApi, j as FlowExecutionEvent, E as EventMessage } from './conversation-list-store-CU5mi_PE.js';
 
 /**
  * React adapters for the RaisinDB conversation stores.

package/dist/index.d.mts

@@ -1,8 +1,8 @@
-import { l as PropertyValue, m as RelationRef, N as Node, H as HttpClientOptions, n as ClientOptions, o as Credentials, p as RaisinHttpClient, R as RaisinClient, q as RetryOptions, U as UploadErrorCode, B as BatchUpload, r as UploaderConfig, s as FileSource, t as BatchUploadOptions, u as BatchUploadResult, v as BatchProgress, w as ReconnectOptions } from './conversation-list-store-S5MPSqoB.mjs';
-export { cK as AiContainerConfig, cJ as AiErrorBehavior, cI as AiToolMode, aa as Archetypes, aW as AuditLogEntry, aV as AuditQueryPayload, G as AuthEvent, A as AuthManager, J as AuthStateChange, K as AuthStateChangeCallback, b9 as AuthenticatePayload, ba as AuthenticateResponse, bG as BatchFileProgress, ad as BranchDiff, ae as BranchDivergence, ac as Branches, bP as BrowserFileSource, d8 as ChatAssistantMessageEvent, da as ChatCompletedEvent, dj as ChatConversationCreatedEvent, dc as ChatDoneEvent, d2 as ChatEvent, db as ChatFailedEvent, dm as ChatLogEvent, b as ChatMessage, dl as ChatMessageDeliveredEvent, dk as ChatMessageSavedEvent, cH as ChatStepConfig, cG as ChatTerminationConfig, cF as ChatTerminationMode, d7 as ChatTextChunkEvent, df as ChatThoughtChunkEvent, de as ChatToolCallCompletedEvent, dd as ChatToolCallStartedEvent, d9 as ChatWaitingEvent, bC as ChunkUploadResponse, x as ClientMode, bE as CompleteUploadRequest, bF as CompleteUploadResponse, az as Connection, aA as ConnectionOptions, C as ConnectionState, cO as ContainerRule, cx as ContainerType, d3 as Conversation, cs as ConversationCreatedEvent, d as ConversationListItem, h as ConversationListSnapshot, e as ConversationListStore, g as ConversationListStoreOptions, dn as ConversationManager, dw as ConversationManagerOptions, d5 as ConversationStatus, c as ConversationStore, f as ConversationStoreOptions, a as ConversationStoreSnapshot, dt as ConversationSubscription, d4 as ConversationType, dr as CreateConvoOptions, bA as CreateUploadRequest, bB as CreateUploadResponse, af as CrossBranchCopySummary, ag as CrossBranchNodeChange, y as CurrentUser, bO as DEFAULT_BATCH_CONCURRENCY, bN as DEFAULT_BRANCH, bI as DEFAULT_CHUNK_SIZE, bJ as DEFAULT_MAX_RETRIES, bM as DEFAULT_NODE_TYPE, bK as DEFAULT_RETRY_BASE_DELAY, bL as DEFAULT_RETRY_MAX_DELAY, dp as DEFAULT_SEND_MESSAGE_INACTIVITY_TIMEOUT_MS, D as Database, Z as DatabaseHttpOptions, ab as ElementTypes, aK as ErrorInfo, ax as EventCallback, av as EventHandler, E as EventMessage, aw as EventSubscriptions, bX as FlowClient, F as FlowClientOptions, bZ as FlowCollectResult, cm as FlowCompletedEvent, cR as FlowDefinition, cP as FlowDefinitionContainer, cQ as FlowDefinitionNode, cL as FlowDefinitionNodeBase, cN as FlowDefinitionStep, cz as FlowErrorStrategy, j as FlowExecutionEvent, cn as FlowFailedEvent, cf as FlowInstanceStatus, cg as FlowInstanceStatusResponse, cl as FlowResumedEvent, ce as FlowRunResponse, bY as FlowRunResult, cM as FlowStepProperties, ck as FlowWaitingEvent, i as FlowsApi, c0 as FunctionInvokeOptions, c1 as FunctionInvokeResponse, c2 as FunctionInvokeSyncResponse, b_ as FunctionsApi, cE as HandoffTarget, aq as HttpArchetypes, V as HttpCurrentUser, O as HttpDatabase, ar as HttpElementTypes, b$ as HttpFunctionsApi, ap as HttpNodeTypes, W as HttpUserNode, Q as HttpWorkspaceClient, cC as HumanTaskType, aF as IdentityAuthError, aE as IdentityAuthResponse, I as IdentityUser, c_ as InboxApi, c$ as InboxApiOptions, cS as InboxTask, cT as InboxTaskStatus, aM as IncomingRelation, dq as ListConversationsOptions, ak as ListInvocationsFilter, d0 as ListTasksOptions, d1 as ListTasksResponse, aC as LocalStorageTokenStorage, cu as LogEvent, bo as LogLevel, bu as LoggerConfig, c9 as McpCallToolResult, c3 as McpClient, c8 as McpContentBlock, c5 as McpFrameStream, c6 as McpJsonRpcFrame, cb as McpReadResourceResult, ca as McpResourceContents, cd as McpResourceSubscription, cc as McpResourceUpdate, c7 as McpToolDescriptor, c4 as McpTransport, aB as MemoryTokenStorage, d6 as MessageBody, dh as MessageChild, ct as MessageSavedEvent, a4 as NodeCreateDeepOptions, aP as NodeCreateDeepPayload, a3 as NodeCreateOptions, aO as NodeCreatePayload, aR as NodeDeletePayload, ah as NodeDiffInfo, aI as NodeEventPayload, bQ as NodeFileSource, aS as NodeGetPayload, aT as NodeHistoryPayload, a2 as NodeOperations, a6 as NodeQueryOptions, aX as NodeQueryPayload, aN as NodeRelationships, a9 as NodeTypes, a5 as NodeUpdateOptions, aQ as NodeUpdatePayload, dv as PlanActionOptions, du as PlanActionReceipt, P as PlanProjection, k as PlanProjectionTask, di as PlanTask, cV as RETRY_STRATEGIES, cw as RaisinReference, bn as ReconnectManager, bb as RefreshTokenPayload, aY as RelationAddPayload, aZ as RelationRemovePayload, a_ as RelationsGetPayload, aJ as RequestContext, aG as RequestEnvelope, bh as RequestType, aH as ResponseEnvelope, aL as ResponseMetadata, bi as ResponseStatus, cA as RetryConfig, cB as RetryStrategy, aU as RevisionEntry, al as ScheduleInvocationOptions, am as ScheduledInvocation, an as ScheduledInvocationRef, ao as ScheduledInvocationTargetKind, aj as SchedulerApi, as as SchemaCommit, ds as SendMessageOptions, X as SignAssetOptions, Y as SignedAssetUrl, at as SqlQuery, a$ as SqlQueryPayload, b0 as SqlResult, ci as StepCompletedEvent, cy as StepErrorBehavior, cj as StepFailedEvent, ch as StepStartedEvent, b6 as SubscribePayload, ay as Subscription, S as SubscriptionFilters, b8 as SubscriptionResponse, ai as Tags, cU as TaskCompletionResult, cD as TaskOption, co as TextChunkEvent, cr as ThoughtChunkEvent, aD as TokenStorage, cq as ToolCallCompletedEvent, T as ToolCallInfo, dg as ToolCallRecord, cp as ToolCallStartedEvent, a7 as Transaction, bc as TransactionBeginPayload, bd as TransactionBeginResponse, be as TransactionCommitPayload, bf as TransactionCommitResponse, a8 as TransactionOptions, bg as TransactionRollbackPayload, b7 as UnsubscribePayload, bz as Upload, bH as UploadError, bW as UploadManager, bw as UploadOptions, bx as UploadProgress, by as UploadResult, bv as UploadStatus, bD as UploadStatusResponse, bV as Uploader, M as UserChangeCallback, L as UserChangeEvent, z as UserNode, b1 as Workspace, _ as WorkspaceClient, a0 as WorkspaceCreateOptions, b2 as WorkspaceCreatePayload, b4 as WorkspaceDeletePayload, b3 as WorkspaceGetPayload, $ as WorkspaceManager, a1 as WorkspaceUpdateOptions, b5 as WorkspaceUpdatePayload, bT as calculateChunkCount, bq as configureLogger, bR as createFileSource, au as createSqlHandler, bk as decodeMessage, bj as encodeMessage, bU as getChunkRange, bS as getContentType, bs as getLogLevel, bt as getLoggerConfig, cW as getRefDisplayName, cX as getRefPath, bl as isEventMessage, cZ as isFlowDefinitionContainer, cY as isFlowDefinitionStep, bm as isResponseEnvelope, cv as isTerminalEvent, bp as logger, dx as projectPlansFromMessages, br as setLogLevel } from './conversation-list-store-S5MPSqoB.mjs';
-export { F as FlowStatus, j as RaisinContextValue, i as RaisinProviderProps, g as RaisinReact, R as ReactLike, h as ReactLikeWithContext, k as UseAuthReturn, l as UseConnectionReturn, b as UseConversationListReturn, U as UseConversationReturn, d as UseFlowOptions, e as UseFlowReturn, m as UseSqlOptions, n as UseSqlReturn, o as UseSubscriptionOptions, f as createRaisinReact, u as useConversation, a as useConversationList, c as useFlow } from './index-3-fS4i8b.mjs';
+import { l as PropertyValue, m as RelationRef, N as Node, H as HttpClientOptions, n as ClientOptions, o as Credentials, p as RaisinHttpClient, R as RaisinClient, q as RetryOptions, U as UploadErrorCode, B as BatchUpload, r as UploaderConfig, s as FileSource, t as BatchUploadOptions, u as BatchUploadResult, v as BatchProgress, w as ReconnectOptions } from './conversation-list-store-CU5mi_PE.mjs';
+export { cK as AiContainerConfig, cJ as AiErrorBehavior, cI as AiToolMode, aa as Archetypes, aW as AuditLogEntry, aV as AuditQueryPayload, G as AuthEvent, A as AuthManager, J as AuthStateChange, K as AuthStateChangeCallback, b9 as AuthenticatePayload, ba as AuthenticateResponse, bG as BatchFileProgress, ad as BranchDiff, ae as BranchDivergence, ac as Branches, bP as BrowserFileSource, d8 as ChatAssistantMessageEvent, da as ChatCompletedEvent, dj as ChatConversationCreatedEvent, dc as ChatDoneEvent, d2 as ChatEvent, db as ChatFailedEvent, dm as ChatLogEvent, b as ChatMessage, dl as ChatMessageDeliveredEvent, dk as ChatMessageSavedEvent, cH as ChatStepConfig, cG as ChatTerminationConfig, cF as ChatTerminationMode, d7 as ChatTextChunkEvent, df as ChatThoughtChunkEvent, de as ChatToolCallCompletedEvent, dd as ChatToolCallStartedEvent, d9 as ChatWaitingEvent, bC as ChunkUploadResponse, x as ClientMode, bE as CompleteUploadRequest, bF as CompleteUploadResponse, az as Connection, aA as ConnectionOptions, C as ConnectionState, cO as ContainerRule, cx as ContainerType, d3 as Conversation, cs as ConversationCreatedEvent, d as ConversationListItem, h as ConversationListSnapshot, e as ConversationListStore, g as ConversationListStoreOptions, dn as ConversationManager, dw as ConversationManagerOptions, d5 as ConversationStatus, c as ConversationStore, f as ConversationStoreOptions, a as ConversationStoreSnapshot, dt as ConversationSubscription, d4 as ConversationType, dr as CreateConvoOptions, bA as CreateUploadRequest, bB as CreateUploadResponse, af as CrossBranchCopySummary, ag as CrossBranchNodeChange, y as CurrentUser, bO as DEFAULT_BATCH_CONCURRENCY, bN as DEFAULT_BRANCH, bI as DEFAULT_CHUNK_SIZE, bJ as DEFAULT_MAX_RETRIES, bM as DEFAULT_NODE_TYPE, bK as DEFAULT_RETRY_BASE_DELAY, bL as DEFAULT_RETRY_MAX_DELAY, dp as DEFAULT_SEND_MESSAGE_INACTIVITY_TIMEOUT_MS, D as Database, Z as DatabaseHttpOptions, ab as ElementTypes, aK as ErrorInfo, ax as EventCallback, av as EventHandler, E as EventMessage, aw as EventSubscriptions, bX as FlowClient, F as FlowClientOptions, bZ as FlowCollectResult, cm as FlowCompletedEvent, cR as FlowDefinition, cP as FlowDefinitionContainer, cQ as FlowDefinitionNode, cL as FlowDefinitionNodeBase, cN as FlowDefinitionStep, cz as FlowErrorStrategy, j as FlowExecutionEvent, cn as FlowFailedEvent, cf as FlowInstanceStatus, cg as FlowInstanceStatusResponse, cl as FlowResumedEvent, ce as FlowRunResponse, bY as FlowRunResult, cM as FlowStepProperties, ck as FlowWaitingEvent, i as FlowsApi, c0 as FunctionInvokeOptions, c1 as FunctionInvokeResponse, c2 as FunctionInvokeSyncResponse, b_ as FunctionsApi, cE as HandoffTarget, aq as HttpArchetypes, V as HttpCurrentUser, O as HttpDatabase, ar as HttpElementTypes, b$ as HttpFunctionsApi, ap as HttpNodeTypes, W as HttpUserNode, Q as HttpWorkspaceClient, cC as HumanTaskType, aF as IdentityAuthError, aE as IdentityAuthResponse, I as IdentityUser, c_ as InboxApi, c$ as InboxApiOptions, cS as InboxTask, cT as InboxTaskStatus, aM as IncomingRelation, dq as ListConversationsOptions, ak as ListInvocationsFilter, d0 as ListTasksOptions, d1 as ListTasksResponse, aC as LocalStorageTokenStorage, cu as LogEvent, bo as LogLevel, bu as LoggerConfig, c9 as McpCallToolResult, c3 as McpClient, c8 as McpContentBlock, c5 as McpFrameStream, c6 as McpJsonRpcFrame, cb as McpReadResourceResult, ca as McpResourceContents, cd as McpResourceSubscription, cc as McpResourceUpdate, c7 as McpToolDescriptor, c4 as McpTransport, aB as MemoryTokenStorage, d6 as MessageBody, dh as MessageChild, ct as MessageSavedEvent, a4 as NodeCreateDeepOptions, aP as NodeCreateDeepPayload, a3 as NodeCreateOptions, aO as NodeCreatePayload, aR as NodeDeletePayload, ah as NodeDiffInfo, aI as NodeEventPayload, bQ as NodeFileSource, aS as NodeGetPayload, aT as NodeHistoryPayload, a2 as NodeOperations, a6 as NodeQueryOptions, aX as NodeQueryPayload, aN as NodeRelationships, a9 as NodeTypes, a5 as NodeUpdateOptions, aQ as NodeUpdatePayload, dv as PlanActionOptions, du as PlanActionReceipt, P as PlanProjection, k as PlanProjectionTask, di as PlanTask, cV as RETRY_STRATEGIES, cw as RaisinReference, bn as ReconnectManager, bb as RefreshTokenPayload, aY as RelationAddPayload, aZ as RelationRemovePayload, a_ as RelationsGetPayload, aJ as RequestContext, aG as RequestEnvelope, bh as RequestType, aH as ResponseEnvelope, aL as ResponseMetadata, bi as ResponseStatus, cA as RetryConfig, cB as RetryStrategy, aU as RevisionEntry, al as ScheduleInvocationOptions, am as ScheduledInvocation, an as ScheduledInvocationRef, ao as ScheduledInvocationTargetKind, aj as SchedulerApi, as as SchemaCommit, ds as SendMessageOptions, X as SignAssetOptions, Y as SignedAssetUrl, at as SqlQuery, a$ as SqlQueryPayload, b0 as SqlResult, ci as StepCompletedEvent, cy as StepErrorBehavior, cj as StepFailedEvent, ch as StepStartedEvent, b6 as SubscribePayload, ay as Subscription, S as SubscriptionFilters, b8 as SubscriptionResponse, ai as Tags, cU as TaskCompletionResult, cD as TaskOption, co as TextChunkEvent, cr as ThoughtChunkEvent, aD as TokenStorage, cq as ToolCallCompletedEvent, T as ToolCallInfo, dg as ToolCallRecord, cp as ToolCallStartedEvent, a7 as Transaction, bc as TransactionBeginPayload, bd as TransactionBeginResponse, be as TransactionCommitPayload, bf as TransactionCommitResponse, a8 as TransactionOptions, bg as TransactionRollbackPayload, b7 as UnsubscribePayload, bz as Upload, bH as UploadError, bW as UploadManager, bw as UploadOptions, bx as UploadProgress, by as UploadResult, bv as UploadStatus, bD as UploadStatusResponse, bV as Uploader, M as UserChangeCallback, L as UserChangeEvent, z as UserNode, b1 as Workspace, _ as WorkspaceClient, a0 as WorkspaceCreateOptions, b2 as WorkspaceCreatePayload, b4 as WorkspaceDeletePayload, b3 as WorkspaceGetPayload, $ as WorkspaceManager, a1 as WorkspaceUpdateOptions, b5 as WorkspaceUpdatePayload, bT as calculateChunkCount, bq as configureLogger, bR as createFileSource, au as createSqlHandler, bk as decodeMessage, bj as encodeMessage, bU as getChunkRange, bS as getContentType, bs as getLogLevel, bt as getLoggerConfig, cW as getRefDisplayName, cX as getRefPath, bl as isEventMessage, cZ as isFlowDefinitionContainer, cY as isFlowDefinitionStep, bm as isResponseEnvelope, cv as isTerminalEvent, bp as logger, dx as projectPlansFromMessages, br as setLogLevel } from './conversation-list-store-CU5mi_PE.mjs';
+export { F as FlowStatus, j as RaisinContextValue, i as RaisinProviderProps, g as RaisinReact, R as ReactLike, h as ReactLikeWithContext, k as UseAuthReturn, l as UseConnectionReturn, b as UseConversationListReturn, U as UseConversationReturn, d as UseFlowOptions, e as UseFlowReturn, m as UseSqlOptions, n as UseSqlReturn, o as UseSubscriptionOptions, f as createRaisinReact, u as useConversation, a as useConversationList, c as useFlow } from './index-DDus5a7P.mjs';
 export { AuthAdapter, AuthSnapshot, ConnectionAdapter, ConnectionSnapshot, FlowAdapter, FlowAdapterOptions, FlowSnapshot, RAISIN_CONTEXT_KEY, RaisinContext, SubscriptionAdapter, FlowStatus as SvelteFlowStatus, createAuthAdapter, createConnectionAdapter, createConversationAdapter, createConversationListAdapter, createFlowAdapter, createSubscriptionAdapter } from './svelte.mjs';
-export { b as SqlAdapter, S as SqlAdapterOptions, a as SqlSnapshot, c as createSqlAdapter } from './svelte-sql-BCuXrg8L.mjs';
+export { b as SqlAdapter, S as SqlAdapterOptions, a as SqlSnapshot, c as createSqlAdapter } from './svelte-sql-CpXHXg34.mjs';
 export { RaisinVue, VueComputedRef, VueLike, VueRef, createRaisinVue } from './vue.mjs';
 import 'events';
 import 'fs/promises';
@@ -65,7 +65,12 @@ declare class NodeBuilder {
      */
     children(children: string[]): this;
     /**
-     * Set the order key
+     * Set the order key.
+     *
+     * @deprecated The server owns editorial ordering: the order key is assigned by
+     * the ordering index on write, so any value set here is overwritten. To place a
+     * node, create it (it appends to the end of its parent) then call
+     * `nodes.reorder()`, `nodes.moveChildBefore()` or `nodes.moveChildAfter()`.
      */
     orderKey(orderKey: string): this;
     /**

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-import { l as PropertyValue, m as RelationRef, N as Node, H as HttpClientOptions, n as ClientOptions, o as Credentials, p as RaisinHttpClient, R as RaisinClient, q as RetryOptions, U as UploadErrorCode, B as BatchUpload, r as UploaderConfig, s as FileSource, t as BatchUploadOptions, u as BatchUploadResult, v as BatchProgress, w as ReconnectOptions } from './conversation-list-store-S5MPSqoB.js';
-export { cK as AiContainerConfig, cJ as AiErrorBehavior, cI as AiToolMode, aa as Archetypes, aW as AuditLogEntry, aV as AuditQueryPayload, G as AuthEvent, A as AuthManager, J as AuthStateChange, K as AuthStateChangeCallback, b9 as AuthenticatePayload, ba as AuthenticateResponse, bG as BatchFileProgress, ad as BranchDiff, ae as BranchDivergence, ac as Branches, bP as BrowserFileSource, d8 as ChatAssistantMessageEvent, da as ChatCompletedEvent, dj as ChatConversationCreatedEvent, dc as ChatDoneEvent, d2 as ChatEvent, db as ChatFailedEvent, dm as ChatLogEvent, b as ChatMessage, dl as ChatMessageDeliveredEvent, dk as ChatMessageSavedEvent, cH as ChatStepConfig, cG as ChatTerminationConfig, cF as ChatTerminationMode, d7 as ChatTextChunkEvent, df as ChatThoughtChunkEvent, de as ChatToolCallCompletedEvent, dd as ChatToolCallStartedEvent, d9 as ChatWaitingEvent, bC as ChunkUploadResponse, x as ClientMode, bE as CompleteUploadRequest, bF as CompleteUploadResponse, az as Connection, aA as ConnectionOptions, C as ConnectionState, cO as ContainerRule, cx as ContainerType, d3 as Conversation, cs as ConversationCreatedEvent, d as ConversationListItem, h as ConversationListSnapshot, e as ConversationListStore, g as ConversationListStoreOptions, dn as ConversationManager, dw as ConversationManagerOptions, d5 as ConversationStatus, c as ConversationStore, f as ConversationStoreOptions, a as ConversationStoreSnapshot, dt as ConversationSubscription, d4 as ConversationType, dr as CreateConvoOptions, bA as CreateUploadRequest, bB as CreateUploadResponse, af as CrossBranchCopySummary, ag as CrossBranchNodeChange, y as CurrentUser, bO as DEFAULT_BATCH_CONCURRENCY, bN as DEFAULT_BRANCH, bI as DEFAULT_CHUNK_SIZE, bJ as DEFAULT_MAX_RETRIES, bM as DEFAULT_NODE_TYPE, bK as DEFAULT_RETRY_BASE_DELAY, bL as DEFAULT_RETRY_MAX_DELAY, dp as DEFAULT_SEND_MESSAGE_INACTIVITY_TIMEOUT_MS, D as Database, Z as DatabaseHttpOptions, ab as ElementTypes, aK as ErrorInfo, ax as EventCallback, av as EventHandler, E as EventMessage, aw as EventSubscriptions, bX as FlowClient, F as FlowClientOptions, bZ as FlowCollectResult, cm as FlowCompletedEvent, cR as FlowDefinition, cP as FlowDefinitionContainer, cQ as FlowDefinitionNode, cL as FlowDefinitionNodeBase, cN as FlowDefinitionStep, cz as FlowErrorStrategy, j as FlowExecutionEvent, cn as FlowFailedEvent, cf as FlowInstanceStatus, cg as FlowInstanceStatusResponse, cl as FlowResumedEvent, ce as FlowRunResponse, bY as FlowRunResult, cM as FlowStepProperties, ck as FlowWaitingEvent, i as FlowsApi, c0 as FunctionInvokeOptions, c1 as FunctionInvokeResponse, c2 as FunctionInvokeSyncResponse, b_ as FunctionsApi, cE as HandoffTarget, aq as HttpArchetypes, V as HttpCurrentUser, O as HttpDatabase, ar as HttpElementTypes, b$ as HttpFunctionsApi, ap as HttpNodeTypes, W as HttpUserNode, Q as HttpWorkspaceClient, cC as HumanTaskType, aF as IdentityAuthError, aE as IdentityAuthResponse, I as IdentityUser, c_ as InboxApi, c$ as InboxApiOptions, cS as InboxTask, cT as InboxTaskStatus, aM as IncomingRelation, dq as ListConversationsOptions, ak as ListInvocationsFilter, d0 as ListTasksOptions, d1 as ListTasksResponse, aC as LocalStorageTokenStorage, cu as LogEvent, bo as LogLevel, bu as LoggerConfig, c9 as McpCallToolResult, c3 as McpClient, c8 as McpContentBlock, c5 as McpFrameStream, c6 as McpJsonRpcFrame, cb as McpReadResourceResult, ca as McpResourceContents, cd as McpResourceSubscription, cc as McpResourceUpdate, c7 as McpToolDescriptor, c4 as McpTransport, aB as MemoryTokenStorage, d6 as MessageBody, dh as MessageChild, ct as MessageSavedEvent, a4 as NodeCreateDeepOptions, aP as NodeCreateDeepPayload, a3 as NodeCreateOptions, aO as NodeCreatePayload, aR as NodeDeletePayload, ah as NodeDiffInfo, aI as NodeEventPayload, bQ as NodeFileSource, aS as NodeGetPayload, aT as NodeHistoryPayload, a2 as NodeOperations, a6 as NodeQueryOptions, aX as NodeQueryPayload, aN as NodeRelationships, a9 as NodeTypes, a5 as NodeUpdateOptions, aQ as NodeUpdatePayload, dv as PlanActionOptions, du as PlanActionReceipt, P as PlanProjection, k as PlanProjectionTask, di as PlanTask, cV as RETRY_STRATEGIES, cw as RaisinReference, bn as ReconnectManager, bb as RefreshTokenPayload, aY as RelationAddPayload, aZ as RelationRemovePayload, a_ as RelationsGetPayload, aJ as RequestContext, aG as RequestEnvelope, bh as RequestType, aH as ResponseEnvelope, aL as ResponseMetadata, bi as ResponseStatus, cA as RetryConfig, cB as RetryStrategy, aU as RevisionEntry, al as ScheduleInvocationOptions, am as ScheduledInvocation, an as ScheduledInvocationRef, ao as ScheduledInvocationTargetKind, aj as SchedulerApi, as as SchemaCommit, ds as SendMessageOptions, X as SignAssetOptions, Y as SignedAssetUrl, at as SqlQuery, a$ as SqlQueryPayload, b0 as SqlResult, ci as StepCompletedEvent, cy as StepErrorBehavior, cj as StepFailedEvent, ch as StepStartedEvent, b6 as SubscribePayload, ay as Subscription, S as SubscriptionFilters, b8 as SubscriptionResponse, ai as Tags, cU as TaskCompletionResult, cD as TaskOption, co as TextChunkEvent, cr as ThoughtChunkEvent, aD as TokenStorage, cq as ToolCallCompletedEvent, T as ToolCallInfo, dg as ToolCallRecord, cp as ToolCallStartedEvent, a7 as Transaction, bc as TransactionBeginPayload, bd as TransactionBeginResponse, be as TransactionCommitPayload, bf as TransactionCommitResponse, a8 as TransactionOptions, bg as TransactionRollbackPayload, b7 as UnsubscribePayload, bz as Upload, bH as UploadError, bW as UploadManager, bw as UploadOptions, bx as UploadProgress, by as UploadResult, bv as UploadStatus, bD as UploadStatusResponse, bV as Uploader, M as UserChangeCallback, L as UserChangeEvent, z as UserNode, b1 as Workspace, _ as WorkspaceClient, a0 as WorkspaceCreateOptions, b2 as WorkspaceCreatePayload, b4 as WorkspaceDeletePayload, b3 as WorkspaceGetPayload, $ as WorkspaceManager, a1 as WorkspaceUpdateOptions, b5 as WorkspaceUpdatePayload, bT as calculateChunkCount, bq as configureLogger, bR as createFileSource, au as createSqlHandler, bk as decodeMessage, bj as encodeMessage, bU as getChunkRange, bS as getContentType, bs as getLogLevel, bt as getLoggerConfig, cW as getRefDisplayName, cX as getRefPath, bl as isEventMessage, cZ as isFlowDefinitionContainer, cY as isFlowDefinitionStep, bm as isResponseEnvelope, cv as isTerminalEvent, bp as logger, dx as projectPlansFromMessages, br as setLogLevel } from './conversation-list-store-S5MPSqoB.js';
-export { F as FlowStatus, j as RaisinContextValue, i as RaisinProviderProps, g as RaisinReact, R as ReactLike, h as ReactLikeWithContext, k as UseAuthReturn, l as UseConnectionReturn, b as UseConversationListReturn, U as UseConversationReturn, d as UseFlowOptions, e as UseFlowReturn, m as UseSqlOptions, n as UseSqlReturn, o as UseSubscriptionOptions, f as createRaisinReact, u as useConversation, a as useConversationList, c as useFlow } from './index-Bs7UkpRs.js';
+import { l as PropertyValue, m as RelationRef, N as Node, H as HttpClientOptions, n as ClientOptions, o as Credentials, p as RaisinHttpClient, R as RaisinClient, q as RetryOptions, U as UploadErrorCode, B as BatchUpload, r as UploaderConfig, s as FileSource, t as BatchUploadOptions, u as BatchUploadResult, v as BatchProgress, w as ReconnectOptions } from './conversation-list-store-CU5mi_PE.js';
+export { cK as AiContainerConfig, cJ as AiErrorBehavior, cI as AiToolMode, aa as Archetypes, aW as AuditLogEntry, aV as AuditQueryPayload, G as AuthEvent, A as AuthManager, J as AuthStateChange, K as AuthStateChangeCallback, b9 as AuthenticatePayload, ba as AuthenticateResponse, bG as BatchFileProgress, ad as BranchDiff, ae as BranchDivergence, ac as Branches, bP as BrowserFileSource, d8 as ChatAssistantMessageEvent, da as ChatCompletedEvent, dj as ChatConversationCreatedEvent, dc as ChatDoneEvent, d2 as ChatEvent, db as ChatFailedEvent, dm as ChatLogEvent, b as ChatMessage, dl as ChatMessageDeliveredEvent, dk as ChatMessageSavedEvent, cH as ChatStepConfig, cG as ChatTerminationConfig, cF as ChatTerminationMode, d7 as ChatTextChunkEvent, df as ChatThoughtChunkEvent, de as ChatToolCallCompletedEvent, dd as ChatToolCallStartedEvent, d9 as ChatWaitingEvent, bC as ChunkUploadResponse, x as ClientMode, bE as CompleteUploadRequest, bF as CompleteUploadResponse, az as Connection, aA as ConnectionOptions, C as ConnectionState, cO as ContainerRule, cx as ContainerType, d3 as Conversation, cs as ConversationCreatedEvent, d as ConversationListItem, h as ConversationListSnapshot, e as ConversationListStore, g as ConversationListStoreOptions, dn as ConversationManager, dw as ConversationManagerOptions, d5 as ConversationStatus, c as ConversationStore, f as ConversationStoreOptions, a as ConversationStoreSnapshot, dt as ConversationSubscription, d4 as ConversationType, dr as CreateConvoOptions, bA as CreateUploadRequest, bB as CreateUploadResponse, af as CrossBranchCopySummary, ag as CrossBranchNodeChange, y as CurrentUser, bO as DEFAULT_BATCH_CONCURRENCY, bN as DEFAULT_BRANCH, bI as DEFAULT_CHUNK_SIZE, bJ as DEFAULT_MAX_RETRIES, bM as DEFAULT_NODE_TYPE, bK as DEFAULT_RETRY_BASE_DELAY, bL as DEFAULT_RETRY_MAX_DELAY, dp as DEFAULT_SEND_MESSAGE_INACTIVITY_TIMEOUT_MS, D as Database, Z as DatabaseHttpOptions, ab as ElementTypes, aK as ErrorInfo, ax as EventCallback, av as EventHandler, E as EventMessage, aw as EventSubscriptions, bX as FlowClient, F as FlowClientOptions, bZ as FlowCollectResult, cm as FlowCompletedEvent, cR as FlowDefinition, cP as FlowDefinitionContainer, cQ as FlowDefinitionNode, cL as FlowDefinitionNodeBase, cN as FlowDefinitionStep, cz as FlowErrorStrategy, j as FlowExecutionEvent, cn as FlowFailedEvent, cf as FlowInstanceStatus, cg as FlowInstanceStatusResponse, cl as FlowResumedEvent, ce as FlowRunResponse, bY as FlowRunResult, cM as FlowStepProperties, ck as FlowWaitingEvent, i as FlowsApi, c0 as FunctionInvokeOptions, c1 as FunctionInvokeResponse, c2 as FunctionInvokeSyncResponse, b_ as FunctionsApi, cE as HandoffTarget, aq as HttpArchetypes, V as HttpCurrentUser, O as HttpDatabase, ar as HttpElementTypes, b$ as HttpFunctionsApi, ap as HttpNodeTypes, W as HttpUserNode, Q as HttpWorkspaceClient, cC as HumanTaskType, aF as IdentityAuthError, aE as IdentityAuthResponse, I as IdentityUser, c_ as InboxApi, c$ as InboxApiOptions, cS as InboxTask, cT as InboxTaskStatus, aM as IncomingRelation, dq as ListConversationsOptions, ak as ListInvocationsFilter, d0 as ListTasksOptions, d1 as ListTasksResponse, aC as LocalStorageTokenStorage, cu as LogEvent, bo as LogLevel, bu as LoggerConfig, c9 as McpCallToolResult, c3 as McpClient, c8 as McpContentBlock, c5 as McpFrameStream, c6 as McpJsonRpcFrame, cb as McpReadResourceResult, ca as McpResourceContents, cd as McpResourceSubscription, cc as McpResourceUpdate, c7 as McpToolDescriptor, c4 as McpTransport, aB as MemoryTokenStorage, d6 as MessageBody, dh as MessageChild, ct as MessageSavedEvent, a4 as NodeCreateDeepOptions, aP as NodeCreateDeepPayload, a3 as NodeCreateOptions, aO as NodeCreatePayload, aR as NodeDeletePayload, ah as NodeDiffInfo, aI as NodeEventPayload, bQ as NodeFileSource, aS as NodeGetPayload, aT as NodeHistoryPayload, a2 as NodeOperations, a6 as NodeQueryOptions, aX as NodeQueryPayload, aN as NodeRelationships, a9 as NodeTypes, a5 as NodeUpdateOptions, aQ as NodeUpdatePayload, dv as PlanActionOptions, du as PlanActionReceipt, P as PlanProjection, k as PlanProjectionTask, di as PlanTask, cV as RETRY_STRATEGIES, cw as RaisinReference, bn as ReconnectManager, bb as RefreshTokenPayload, aY as RelationAddPayload, aZ as RelationRemovePayload, a_ as RelationsGetPayload, aJ as RequestContext, aG as RequestEnvelope, bh as RequestType, aH as ResponseEnvelope, aL as ResponseMetadata, bi as ResponseStatus, cA as RetryConfig, cB as RetryStrategy, aU as RevisionEntry, al as ScheduleInvocationOptions, am as ScheduledInvocation, an as ScheduledInvocationRef, ao as ScheduledInvocationTargetKind, aj as SchedulerApi, as as SchemaCommit, ds as SendMessageOptions, X as SignAssetOptions, Y as SignedAssetUrl, at as SqlQuery, a$ as SqlQueryPayload, b0 as SqlResult, ci as StepCompletedEvent, cy as StepErrorBehavior, cj as StepFailedEvent, ch as StepStartedEvent, b6 as SubscribePayload, ay as Subscription, S as SubscriptionFilters, b8 as SubscriptionResponse, ai as Tags, cU as TaskCompletionResult, cD as TaskOption, co as TextChunkEvent, cr as ThoughtChunkEvent, aD as TokenStorage, cq as ToolCallCompletedEvent, T as ToolCallInfo, dg as ToolCallRecord, cp as ToolCallStartedEvent, a7 as Transaction, bc as TransactionBeginPayload, bd as TransactionBeginResponse, be as TransactionCommitPayload, bf as TransactionCommitResponse, a8 as TransactionOptions, bg as TransactionRollbackPayload, b7 as UnsubscribePayload, bz as Upload, bH as UploadError, bW as UploadManager, bw as UploadOptions, bx as UploadProgress, by as UploadResult, bv as UploadStatus, bD as UploadStatusResponse, bV as Uploader, M as UserChangeCallback, L as UserChangeEvent, z as UserNode, b1 as Workspace, _ as WorkspaceClient, a0 as WorkspaceCreateOptions, b2 as WorkspaceCreatePayload, b4 as WorkspaceDeletePayload, b3 as WorkspaceGetPayload, $ as WorkspaceManager, a1 as WorkspaceUpdateOptions, b5 as WorkspaceUpdatePayload, bT as calculateChunkCount, bq as configureLogger, bR as createFileSource, au as createSqlHandler, bk as decodeMessage, bj as encodeMessage, bU as getChunkRange, bS as getContentType, bs as getLogLevel, bt as getLoggerConfig, cW as getRefDisplayName, cX as getRefPath, bl as isEventMessage, cZ as isFlowDefinitionContainer, cY as isFlowDefinitionStep, bm as isResponseEnvelope, cv as isTerminalEvent, bp as logger, dx as projectPlansFromMessages, br as setLogLevel } from './conversation-list-store-CU5mi_PE.js';
+export { F as FlowStatus, j as RaisinContextValue, i as RaisinProviderProps, g as RaisinReact, R as ReactLike, h as ReactLikeWithContext, k as UseAuthReturn, l as UseConnectionReturn, b as UseConversationListReturn, U as UseConversationReturn, d as UseFlowOptions, e as UseFlowReturn, m as UseSqlOptions, n as UseSqlReturn, o as UseSubscriptionOptions, f as createRaisinReact, u as useConversation, a as useConversationList, c as useFlow } from './index-sFvMihQA.js';
 export { AuthAdapter, AuthSnapshot, ConnectionAdapter, ConnectionSnapshot, FlowAdapter, FlowAdapterOptions, FlowSnapshot, RAISIN_CONTEXT_KEY, RaisinContext, SubscriptionAdapter, FlowStatus as SvelteFlowStatus, createAuthAdapter, createConnectionAdapter, createConversationAdapter, createConversationListAdapter, createFlowAdapter, createSubscriptionAdapter } from './svelte.js';
-export { b as SqlAdapter, S as SqlAdapterOptions, a as SqlSnapshot, c as createSqlAdapter } from './svelte-sql-DO1X-WO3.js';
+export { b as SqlAdapter, S as SqlAdapterOptions, a as SqlSnapshot, c as createSqlAdapter } from './svelte-sql-B2G94Q9p.js';
 export { RaisinVue, VueComputedRef, VueLike, VueRef, createRaisinVue } from './vue.js';
 import 'events';
 import 'fs/promises';
@@ -65,7 +65,12 @@ declare class NodeBuilder {
      */
     children(children: string[]): this;
     /**
-     * Set the order key
+     * Set the order key.
+     *
+     * @deprecated The server owns editorial ordering: the order key is assigned by
+     * the ordering index on write, so any value set here is overwritten. To place a
+     * node, create it (it appends to the end of its parent) then call
+     * `nodes.reorder()`, `nodes.moveChildBefore()` or `nodes.moveChildAfter()`.
      */
     orderKey(orderKey: string): this;
     /**

package/dist/index.js

@@ -1622,17 +1622,40 @@ var NodeOperations = class {
   // Tree Operations
   // ========================================================================
   /**
-   * List children of a parent node
+   * List children of a parent node, in editorial (drag-and-drop) order.
    *
    * @param parentPath - Path of the parent node
    * @returns Array of child nodes
    */
   async listChildren(parentPath) {
+    const { items } = await this.listChildrenPage(parentPath);
+    return items;
+  }
+  /**
+   * List one page of a parent's children, in editorial order.
+   *
+   * Pagination is keyset-based: pass the previous response's `nextCursor` back as
+   * `cursor` to get the following page. `nextCursor` is `null` on the last page.
+   * Treat the cursor as opaque — do not parse or construct it.
+   *
+   * @param parentPath - Path of the parent node
+   * @param options - `cursor` from a previous page, and page `limit`
+   */
+  async listChildrenPage(parentPath, options = {}) {
     const payload = {
       parent_path: parentPath
     };
+    if (options.cursor !== void 0) payload.cursor = options.cursor;
+    if (options.limit !== void 0) payload.limit = options.limit;
     const result = await this.sendRequest(payload, "node_list_children");
-    return result;
+    if (Array.isArray(result)) {
+      return { items: result, nextCursor: null };
+    }
+    const page = result;
+    return {
+      items: page.nodes ?? [],
+      nextCursor: page.next_cursor == null ? null : JSON.stringify(page.next_cursor)
+    };
   }
   /**
    * Get a node tree starting from a root node
@@ -1740,53 +1763,54 @@ var NodeOperations = class {
     return result;
   }
   /**
-   * Reorder a node by setting a new order key
+   * Move a child to a specific position among its siblings.
    *
-   * @param nodePath - Node path
-   * @param orderKey - New order key (base62-encoded fractional index)
-   * @returns Reordered node
+   * Positions are 0-based; a position past the end appends. The server owns the
+   * fractional order key — you name a position, it mints the key.
+   *
+   * @param parentPath - Parent node path
+   * @param childName - Name of the child to move (not a full path)
+   * @param position - Target 0-based position among the parent's children
+   * @returns The reordered node, carrying its newly assigned `order_key`
    */
-  async reorder(nodePath, orderKey) {
+  async reorder(parentPath, childName, position) {
     const payload = {
-      node_path: nodePath,
-      order_key: orderKey
+      parent_path: parentPath,
+      child_name: childName,
+      position
     };
     const result = await this.sendRequest(payload, "node_reorder");
     return result;
   }
   /**
-   * Move a child node before a reference sibling
+   * Move a child so it sits immediately before one of its siblings.
    *
    * @param parentPath - Parent node path
-   * @param childPath - Child node path to move
-   * @param referencePath - Reference sibling path to position before
-   * @returns Moved node
+   * @param childName - Name of the child to move (not a full path)
+   * @param beforeChildName - Name of the sibling to sit before
    */
-  async moveChildBefore(parentPath, childPath, referencePath) {
+  async moveChildBefore(parentPath, childName, beforeChildName) {
     const payload = {
       parent_path: parentPath,
-      child_path: childPath,
-      reference_path: referencePath
+      child_name: childName,
+      before_child_name: beforeChildName
     };
-    const result = await this.sendRequest(payload, "node_move_child_before");
-    return result;
+    await this.sendRequest(payload, "node_move_child_before");
   }
   /**
-   * Move a child node after a reference sibling
+   * Move a child so it sits immediately after one of its siblings.
    *
    * @param parentPath - Parent node path
-   * @param childPath - Child node path to move
-   * @param referencePath - Reference sibling path to position after
-   * @returns Moved node
+   * @param childName - Name of the child to move (not a full path)
+   * @param afterChildName - Name of the sibling to sit after
    */
-  async moveChildAfter(parentPath, childPath, referencePath) {
+  async moveChildAfter(parentPath, childName, afterChildName) {
     const payload = {
       parent_path: parentPath,
-      child_path: childPath,
-      reference_path: referencePath
+      child_name: childName,
+      after_child_name: afterChildName
     };
-    const result = await this.sendRequest(payload, "node_move_child_after");
-    return result;
+    await this.sendRequest(payload, "node_move_child_after");
   }
   /**
    * Replay a parent's child order from another branch onto the current branch.
@@ -9933,7 +9957,12 @@ var NodeBuilder = class _NodeBuilder {
     return this;
   }
   /**
-   * Set the order key
+   * Set the order key.
+   *
+   * @deprecated The server owns editorial ordering: the order key is assigned by
+   * the ordering index on write, so any value set here is overwritten. To place a
+   * node, create it (it appends to the end of its parent) then call
+   * `nodes.reorder()`, `nodes.moveChildBefore()` or `nodes.moveChildAfter()`.
    */
   orderKey(orderKey) {
     this.node.order_key = orderKey;
@@ -10013,10 +10042,10 @@ var NodeBuilder = class _NodeBuilder {
     if (!this.node.node_type) {
       throw new Error("Node type is required");
     }
+    if (this.node.order_key === void 0) this.node.order_key = "";
     if (!this.node.children) this.node.children = [];
     if (!this.node.relations) this.node.relations = [];
     if (!this.node.properties) this.node.properties = {};
-    if (!this.node.order_key) this.node.order_key = "a";
     if (typeof this.node.version !== "number") this.node.version = 1;
     return this.node;
   }
@@ -10098,8 +10127,8 @@ var NodeHelpers = class {
       node_type: "MockType",
       properties: {},
       children: [],
+      order_key: "",
       relations: [],
-      order_key: "a",
       version: 1,
       ...overrides
     };