Function findBlockIndex

packages/mcp/src/tools/writing.ts:28–36

* Find a block index by ID or ID prefix. Returns -1 if not found.

(blocks: DeepnoteBlock[], idOrPrefix: string)

 * Find a block index by ID or ID prefix. Returns -1 if not found.
 */
function findBlockIndex(blocks: DeepnoteBlock[], idOrPrefix: string): number {
  const matches = blocks
    .map((block, index) => ({ block, index }))
    .filter(({ block }) => block.id === idOrPrefix || block.id.startsWith(idOrPrefix))
  if (matches.length > 1) {
    throw new Error(`Ambiguous block ID prefix "${idOrPrefix}" matches multiple blocks`)
  }
  return matches.length === 1 ? matches[0].index : -1
}

/**
 * Resolve a block ID or prefix to the full block ID. Returns undefined if not found.